# Vis En France — Frontend Technical & Functional Specification

**Version**: 2.0
**Framework**: Next.js 15 (App Router)
**Last Updated**: December 2024

---

## Table of Contents

1. [Project Overview](#1-project-overview)
2. [Tech Stack & Dependencies](#2-tech-stack--dependencies)
3. [Environment Configuration](#3-environment-configuration)
4. [Project Structure](#4-project-structure)
5. [Routing & Pages](#5-routing--pages)
6. [Layout System](#6-layout-system)
7. [Navigation Architecture](#7-navigation-architecture)
8. [Component Specifications](#8-component-specifications)
9. [Advertising System](#9-advertising-system)
10. [Content Architecture](#10-content-architecture)
11. [Feature Flags System](#11-feature-flags-system)
12. [Internationalization (i18n)](#12-internationalization-i18n)
13. [State Management](#13-state-management)
14. [Custom Hooks](#14-custom-hooks)
15. [Authentication System](#15-authentication-system)
16. [Data Layer & Mock Patterns](#16-data-layer--mock-patterns)
17. [Type Definitions](#17-type-definitions)
18. [Styling Guidelines](#18-styling-guidelines)
19. [Accessibility Requirements](#19-accessibility-requirements)
20. [Performance Guidelines](#20-performance-guidelines)
21. [SEO & Meta](#21-seo--meta)
22. [Error Handling](#22-error-handling)
23. [Testing Strategy](#23-testing-strategy)
24. [Development Workflow](#24-development-workflow)
25. [Build Order & Milestones](#25-build-order--milestones)

---

## 1. Project Overview

### Purpose

**Vis En France** is a multilingual web platform providing comprehensive guidance for three distinct audiences navigating French administrative processes:

| Audience | French Slug | English Label | Description |
|----------|-------------|---------------|-------------|
| Students | `etudiants` | Students | Student visa procedures, scholarships, VLS-TS |
| Employees | `salarie` | Employees | Work permits, Passeport Talent, employment contracts |
| Naturalization | `naturalisations` | Naturalization | Citizenship process, eligibility, interviews |

### Core User Flows

1. **Audience Selection** → User selects their situation via top tabs
2. **Section Navigation** → User browses sub-categories via pill navigation
3. **Content Consumption** → User reads articles and guides
4. **Question Submission** → User asks questions via modal form
5. **Ad Interaction** → User views and clicks sponsor advertisements

### Key Features

- Tab-based audience switching with sub-category filtering
- Static guides (Overview, Steps, Documents) per audience
- Dynamic article/update feeds
- Rotating advertisement sidebars (desktop) and banners (mobile)
- Multilingual support (French/English)
- Mock visitor counter for MVP
- Feature flag controlled functionality
- User authentication with role-based access

---

## 2. Tech Stack & Dependencies

### Core Framework

| Package | Version | Purpose |
|---------|---------|---------|
| Next.js | 15.x | React framework with App Router |
| React | 18.3.x | UI library |
| TypeScript | 5.4.x | Type safety |

### Styling

| Package | Version | Purpose |
|---------|---------|---------|
| Tailwind CSS | 3.4.x | Utility-first CSS |
| tailwind-merge | 2.x | Class name conflict resolution |
| clsx | 2.x | Conditional class names |

### State & Data

| Package | Version | Purpose |
|---------|---------|---------|
| Zustand | 4.5.x | Global state management |
| next-intl | 3.20.x | Internationalization |

### UI Components

| Package | Version | Purpose |
|---------|---------|---------|
| Lucide React | 0.400.x | Icon library |
| date-fns | 3.6.x | Date formatting |
| react-google-recaptcha | 3.x | Form protection |

### Development

| Package | Version | Purpose |
|---------|---------|---------|
| ESLint | 8.x | Code linting |
| Prettier | 3.x | Code formatting |
| Playwright | 1.x | E2E testing |
| React Testing Library | 14.x | Component testing |

---

## 3. Environment Configuration

### Environment Variables

Create `.env.local` with the following variables:

```env
# API Configuration
NEXT_PUBLIC_API_BASE=/api
NEXT_PUBLIC_SITE_URL=http://localhost:3000

# Internationalization
NEXT_PUBLIC_DEFAULT_LOCALE=fr
NEXT_PUBLIC_SUPPORTED_LOCALES=fr,en

# Advertising
NEXT_PUBLIC_AD_ROTATION_MS=15000
NEXT_PUBLIC_AD_SLOTS_PER_SIDE=6

# Authentication
NEXT_PUBLIC_JWT_EXPIRY_DAYS=7

# reCAPTCHA
NEXT_PUBLIC_RECAPTCHA_SITE_KEY=your_site_key_here
RECAPTCHA_SECRET_KEY=your_secret_key_here

# Feature Defaults (overridden by API)
NEXT_PUBLIC_ADS_ENABLED=true
NEXT_PUBLIC_FAQ_ENABLED=true
```

### Variable Naming Convention

- `NEXT_PUBLIC_*` — Exposed to browser, use for client-side configuration
- No prefix — Server-only, use for secrets and API keys

---

## 4. Project Structure

```
frontend/
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── layout.tsx # Root layout (html, body, providers)
│ │ ├── page.tsx # Home page (/)
│ │ ├── [locale]/ # Locale-wrapped routes
│ │ │ ├── layout.tsx # Locale provider wrapper
│ │ │ └── page.tsx # Localized home
│ │ ├── articles/
│ │ │ └── [slug]/
│ │ │ └── page.tsx # Article detail
│ │ ├── guides/
│ │ │ └── [audience]/
│ │ │ ├── page.tsx # Guide overview
│ │ │ ├── steps/page.tsx # Step-by-step timeline
│ │ │ └── documents/page.tsx# Document checklist
│ │ ├── faq/
│ │ │ └── page.tsx # Global FAQ
│ │ ├── (admin)/
│ │ │ └── dashboard/
│ │ │ ├── layout.tsx # Admin layout
│ │ │ ├── page.tsx # Dashboard overview
│ │ │ ├── settings/page.tsx # Site settings
│ │ │ ├── articles/page.tsx # Article management
│ │ │ ├── ads/page.tsx # Ad management
│ │ │ └── users/page.tsx # User management
│ │ └── (auth)/
│ │ ├── login/page.tsx # Login page
│ │ └── register/page.tsx # Registration page
│ │
│ ├── components/
│ │ ├── ui/ # Base UI primitives
│ │ │ ├── Button.tsx
│ │ │ ├── Input.tsx
│ │ │ ├── Textarea.tsx
│ │ │ ├── Modal.tsx
│ │ │ ├── Card.tsx
│ │ │ ├── Badge.tsx
│ │ │ ├── Skeleton.tsx
│ │ │ ├── Toast.tsx
│ │ │ └── index.ts
│ │ ├── layout/ # Layout components
│ │ │ ├── Header.tsx
│ │ │ ├── MainLayout.tsx
│ │ │ ├── AdminLayout.tsx
│ │ │ ├── Footer.tsx
│ │ │ └── index.ts
│ │ ├── navigation/ # Navigation components
│ │ │ ├── TabNavigation.tsx
│ │ │ ├── SubNavigation.tsx
│ │ │ ├── LanguageSwitcher.tsx
│ │ │ ├── VisitorCounter.tsx
│ │ │ ├── Breadcrumbs.tsx
│ │ │ └── index.ts
│ │ ├── ads/ # Advertising components
│ │ │ ├── AdCard.tsx
│ │ │ ├── AdRail.tsx
│ │ │ ├── AdMobileBar.tsx
│ │ │ └── index.ts
│ │ ├── content/ # Content display components
│ │ │ ├── ArticleCard.tsx
│ │ │ ├── ArticleList.tsx
│ │ │ ├── ArticleContent.tsx
│ │ │ ├── GuideOverview.tsx
│ │ │ ├── StepTimeline.tsx
│ │ │ ├── DocumentChecklist.tsx
│ │ │ ├── UpdateCard.tsx
│ │ │ ├── UpdateFeed.tsx
│ │ │ ├── FAQList.tsx
│ │ │ ├── FAQItem.tsx
│ │ │ └── index.ts
│ │ ├── forms/ # Form components
│ │ │ ├── QuestionForm.tsx
│ │ │ ├── LoginForm.tsx
│ │ │ ├── RegisterForm.tsx
│ │ │ ├── FilterBar.tsx
│ │ │ ├── SearchInput.tsx
│ │ │ └── index.ts
│ │ ├── modals/ # Modal dialogs
│ │ │ ├── QuestionModal.tsx
│ │ │ ├── AdvertiseModal.tsx
│ │ │ ├── AdBookingModal.tsx
│ │ │ ├── LoginModal.tsx
│ │ │ ├── RegisterModal.tsx
│ │ │ ├── ConfirmModal.tsx
│ │ │ └── index.ts
│ │ ├── admin/ # Admin-specific components
│ │ │ ├── Sidebar.tsx
│ │ │ ├── StatsCard.tsx
│ │ │ ├── DataTable.tsx
│ │ │ ├── FeatureToggle.tsx
│ │ │ └── index.ts
│ │ └── common/ # Shared utilities
│ │ ├── EmptyState.tsx
│ │ ├── ErrorBoundary.tsx
│ │ ├── LoadingSpinner.tsx
│ │ ├── ProtectedRoute.tsx
│ │ └── index.ts
│ │
│ ├── stores/ # Zustand state stores
│ │ ├── navigation-store.ts
│ │ ├── auth-store.ts
│ │ ├── config-store.ts
│ │ ├── ads-store.ts
│ │ ├── modal-store.ts
│ │ ├── locale-store.ts
│ │ └── index.ts
│ │
│ ├── hooks/ # Custom React hooks
│ │ ├── useAuth.ts
│ │ ├── useFeatureFlag.ts
│ │ ├── useAdRotation.ts
│ │ ├── useIntersectionImpression.ts
│ │ ├── useMockVisitors.ts
│ │ ├── useLocale.ts
│ │ ├── useMediaQuery.ts
│ │ └── index.ts
│ │
│ ├── lib/ # Utili

README.md

@@ -1,10 +1,13 @@
 ---
-title: Administrative Aide Visualizer
-emoji: 👀
-colorFrom: green
-colorTo: purple
+title: Administrative Aide Visualizer 🏛️
+colorFrom: yellow
+colorTo: red
+emoji: 🐳
 sdk: static
 pinned: false
+tags:
+  - deepsite-v3
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Welcome to your new DeepSite project!
+This project was created with [DeepSite](https://huggingface.co/deepsite).

index.html

@@ -1,19 +1,253 @@
-<!doctype html>
-<html>
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width" />
-		<title>My static Space</title>
-		<link rel="stylesheet" href="style.css" />
-	</head>
-	<body>
-		<div class="card">
-			<h1>Welcome to your static Space!</h1>
-			<p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
-			<p>
-				Also don't forget to check the
-				<a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
-			</p>
-		</div>
-	</body>
-</html>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Administrative Aide Visualizer</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <script src="https://unpkg.com/feather-icons"></script>
+    <script src="https://cdn.jsdelivr.net/npm/feather-icons/dist/feather.min.js"></script>
+    <link rel="stylesheet" href="style.css">
+    <script>
+        tailwind.config = {
+            theme: {
+                extend: {
+                    colors: {
+                        primary: {
+                            50: '#f0f9ff',
+                            100: '#e0f2fe',
+                            200: '#bae6fd',
+                            300: '#7dd3fc',
+                            400: '#38bdf8',
+                            500: '#0ea5e9',
+                            600: '#0284c7',
+                            700: '#0369a1',
+                            800: '#075985',
+                            900: '#0c4a6e',
+                        },
+                        secondary: {
+                            50: '#f5f3ff',
+                            100: '#ede9fe',
+                            200: '#ddd6fe',
+                            300: '#c4b5fd',
+                            400: '#a78bfa',
+                            500: '#8b5cf6',
+                            600: '#7c3aed',
+                            700: '#6d28d9',
+                            800: '#5b21b6',
+                            900: '#4c1d95',
+                        }
+                    }
+                }
+            }
+        }
+    </script>
+</head>
+<body class="bg-gray-50">
+    <!-- Navigation -->
+    <nav class="bg-white shadow-sm">
+        <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+            <div class="flex justify-between h-16">
+                <div class="flex items-center">
+                    <i data-feather="book" class="text-primary-600 mr-2"></i>
+                    <span class="text-xl font-bold text-gray-800">AdminAide</span>
+                </div>
+                <div class="flex items-center space-x-4">
+                    <a href="#" class="px-3 py-2 rounded-md text-sm font-medium text-gray-700 hover:text-primary-600">Home</a>
+                    <a href="#" class="px-3 py-2 rounded-md text-sm font-medium text-gray-700 hover:text-primary-600">Guides</a>
+                    <a href="#" class="px-3 py-2 rounded-md text-sm font-medium text-gray-700 hover:text-primary-600">FAQ</a>
+                    <button class="bg-primary-500 text-white px-4 py-2 rounded-md text-sm font-medium hover:bg-primary-600">
+                        Ask Question
+                    </button>
+                </div>
+            </div>
+        </div>
+    </nav>
+
+    <!-- Hero Section -->
+    <div class="bg-gradient-to-r from-primary-500 to-secondary-500">
+        <div class="max-w-7xl mx-auto py-12 px-4 sm:px-6 lg:px-8 lg:py-24">
+            <div class="text-center">
+                <h1 class="text-4xl font-extrabold tracking-tight text-white sm:text-5xl lg:text-6xl">
+                    Navigate French Administration
+                </h1>
+                <p class="mt-6 max-w-3xl mx-auto text-xl text-primary-100">
+                    Comprehensive guides for students, employees, and citizenship applicants
+                </p>
+                <div class="mt-10 flex justify-center space-x-4">
+                    <a href="#" class="inline-flex items-center px-6 py-3 border border-transparent text-base font-medium rounded-md shadow-sm text-primary-700 bg-white hover:bg-gray-50">
+                        Get Started
+                    </a>
+                    <a href="#" class="inline-flex items-center px-6 py-3 border border-transparent text-base font-medium rounded-md shadow-sm text-white bg-primary-700 bg-opacity-60 hover:bg-opacity-70">
+                        Watch Video
+                    </a>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- Main Content -->
+    <main class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
+        <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
+            <!-- Student Card -->
+            <div class="bg-white rounded-lg shadow-md overflow-hidden transition-transform hover:scale-105">
+                <div class="bg-primary-100 p-6">
+                    <div class="flex items-center">
+                        <i data-feather="book-open" class="text-primary-600 mr-3"></i>
+                        <h2 class="text-xl font-bold text-gray-800">Students</h2>
+                    </div>
+                </div>
+                <div class="p-6">
+                    <p class="text-gray-600 mb-4">Everything about student visas, university registration, and scholarship applications.</p>
+                    <a href="#" class="inline-flex items-center text-primary-600 hover:text-primary-800">
+                        Student guide
+                        <i data-feather="arrow-right" class="ml-1 w-4 h-4"></i>
+                    </a>
+                </div>
+            </div>
+
+            <!-- Employee Card -->
+            <div class="bg-white rounded-lg shadow-md overflow-hidden transition-transform hover:scale-105">
+                <div class="bg-secondary-100 p-6">
+                    <div class="flex items-center">
+                        <i data-feather="briefcase" class="text-secondary-600 mr-3"></i>
+                        <h2 class="text-xl font-bold text-gray-800">Employees</h2>
+                    </div>
+                </div>
+                <div class="p-6">
+                    <p class="text-gray-600 mb-4">Work permits, employment contracts, and professional visa requirements.</p>
+                    <a href="#" class="inline-flex items-center text-secondary-600 hover:text-secondary-800">
+                        Employee guide
+                        <i data-feather="arrow-right" class="ml-1 w-4 h-4"></i>
+                    </a>
+                </div>
+            </div>
+
+            <!-- Naturalization Card -->
+            <div class="bg-white rounded-lg shadow-md overflow-hidden transition-transform hover:scale-105">
+                <div class="bg-gray-100 p-6">
+                    <div class="flex items-center">
+                        <i data-feather="flag" class="text-gray-600 mr-3"></i>
+                        <h2 class="text-xl font-bold text-gray-800">Naturalization</h2>
+                    </div>
+                </div>
+                <div class="p-6">
+                    <p class="text-gray-600 mb-4">Citizenship application process, eligibility criteria, and interview preparation.</p>
+                    <a href="#" class="inline-flex items-center text-gray-600 hover:text-gray-800">
+                        Citizenship guide
+                        <i data-feather="arrow-right" class="ml-1 w-4 h-4"></i>
+                    </a>
+                </div>
+            </div>
+        </div>
+
+        <!-- Updates Section -->
+        <div class="mt-16">
+            <h2 class="text-2xl font-bold text-gray-800 mb-6">Latest Updates</h2>
+            <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
+                <!-- Update 1 -->
+                <div class="bg-white rounded-lg shadow-md overflow-hidden">
+                    <div class="p-6">
+                        <div class="flex items-center mb-3">
+                            <span class="bg-primary-100 text-primary-800 text-xs font-semibold px-2.5 py-0.5 rounded">New</span>
+                            <span class="text-gray-500 text-sm ml-2">May 15, 2023</span>
+                        </div>
+                        <h3 class="text-lg font-semibold text-gray-800 mb-2">Student Visa Fee Changes</h3>
+                        <p class="text-gray-600 mb-4">The French government has announced updated fees for student visa applications effective June 1st.</p>
+                        <a href="#" class="text-primary-600 hover:text-primary-800 text-sm font-medium">Read more →</a>
+                    </div>
+                </div>
+
+                <!-- Update 2 -->
+                <div class="bg-white rounded-lg shadow-md overflow-hidden">
+                    <div class="p-6">
+                        <div class="flex items-center mb-3">
+                            <span class="bg-secondary-100 text-secondary-800 text-xs font-semibold px-2.5 py-0.5 rounded">Update</span>
+                            <span class="text-gray-500 text-sm ml-2">May 10, 2023</span>
+                        </div>
+                        <h3 class="text-lg font-semibold text-gray-800 mb-2">Work Permit Processing Times</h3>
+                        <p class="text-gray-600 mb-4">Current processing times for employee work permits have been reduced by 15% in most regions.</p>
+                        <a href="#" class="text-primary-600 hover:text-primary-800 text-sm font-medium">Read more →</a>
+                    </div>
+                </div>
+
+                <!-- Update 3 -->
+                <div class="bg-white rounded-lg shadow-md overflow-hidden">
+                    <div class="p-6">
+                        <div class="flex items-center mb-3">
+                            <span class="bg-gray-100 text-gray-800 text-xs font-semibold px-2.5 py-0.5 rounded">Notice</span>
+                            <span class="text-gray-500 text-sm ml-2">May 5, 2023</span>
+                        </div>
+                        <h3 class="text-lg font-semibold text-gray-800 mb-2">Citizenship Test Updates</h3>
+                        <p class="text-gray-600 mb-4">The Ministry has published new study materials for the French language and civics tests.</p>
+                        <a href="#" class="text-primary-600 hover:text-primary-800 text-sm font-medium">Read more →</a>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </main>
+
+    <!-- Footer -->
+    <footer class="bg-gray-800 text-white py-12">
+        <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+            <div class="grid grid-cols-1 md:grid-cols-4 gap-8">
+                <div>
+                    <h3 class="text-lg font-semibold mb-4">Administrative Aide</h3>
+                    <p class="text-gray-400">Simplifying French administrative processes for international visitors and residents.</p>
+                </div>
+                <div>
+                    <h4 class="text-sm font-semibold uppercase tracking-wider mb-4">Guides</h4>
+                    <ul class="space-y-2">
+                        <li><a href="#" class="text-gray-400 hover:text-white">Student Visa</a></li>
+                        <li><a href="#" class="text-gray-400 hover:text-white">Work Permits</a></li>
+                        <li><a href="#" class="text-gray-400 hover:text-white">Citizenship</a></li>
+                        <li><a href="#" class="text-gray-400 hover:text-white">Residency</a></li>
+                    </ul>
+                </div>
+                <div>
+                    <h4 class="text-sm font-semibold uppercase tracking-wider mb-4">Resources</h4>
+                    <ul class="space-y-2">
+                        <li><a href="#" class="text-gray-400 hover:text-white">Forms & Documents</a></li>
+                        <li><a href="#" class="text-gray-400 hover:text-white">FAQ</a></li>
+                        <li><a href="#" class="text-gray-400 hover:text-white">Glossary</a></li>
+                        <li><a href="#" class="text-gray-400 hover:text-white">Contact Prefectures</a></li>
+                    </ul>
+                </div>
+                <div>
+                    <h4 class="text-sm font-semibold uppercase tracking-wider mb-4">Connect</h4>
+                    <div class="flex space-x-4">
+                        <a href="#" class="text-gray-400 hover:text-white">
+                            <i data-feather="facebook"></i>
+                        </a>
+                        <a href="#" class="text-gray-400 hover:text-white">
+                            <i data-feather="twitter"></i>
+                        </a>
+                        <a href="#" class="text-gray-400 hover:text-white">
+                            <i data-feather="linkedin"></i>
+                        </a>
+                        <a href="#" class="text-gray-400 hover:text-white">
+                            <i data-feather="mail"></i>
+                        </a>
+                    </div>
+                    <div class="mt-6">
+                        <button class="flex items-center text-gray-400 hover:text-white text-sm">
+                            <i data-feather="globe" class="mr-2"></i>
+                            English
+                            <i data-feather="chevron-down" class="ml-1"></i>
+                        </button>
+                    </div>
+                </div>
+            </div>
+            <div class="mt-12 pt-8 border-t border-gray-700">
+                <p class="text-gray-400 text-sm text-center">© 2023 Administrative Aide Visualizer. All rights reserved.</p>
+            </div>
+        </div>
+    </footer>
+
+    <script src="script.js"></script>
+    <script>
+        feather.replace();
+    </script>
+<script src="https://huggingface.co/deepsite/deepsite-badge.js"></script>
+</body>
+</html>

script.js

@@ -0,0 +1,91 @@
+document.addEventListener('DOMContentLoaded', function() {
+    // Initialize tooltips
+    const tooltipTriggers = document.querySelectorAll('[data-tooltip]');
+    tooltipTriggers.forEach(trigger => {
+        const tooltip = document.createElement('div');
+        tooltip.className = 'hidden bg-gray-800 text-white text-xs rounded py-1 px-2 absolute z-50';
+        tooltip.textContent = trigger.getAttribute('data-tooltip');
+        document.body.appendChild(tooltip);
+        
+        trigger.addEventListener('mouseenter', () => {
+            const rect = trigger.getBoundingClientRect();
+            tooltip.style.top = `${rect.top - 30}px`;
+            tooltip.style.left = `${rect.left + rect.width / 2}px`;
+            tooltip.style.transform = 'translateX(-50%)';
+            tooltip.classList.remove('hidden');
+        });
+        
+        trigger.addEventListener('mouseleave', () => {
+            tooltip.classList.add('hidden');
+        });
+    });
+
+    // Mock visitor counter animation
+    const visitorCounter = document.getElementById('visitor-counter');
+    if (visitorCounter) {
+        let count = Math.floor(Math.random() * 100) + 50;
+        setInterval(() => {
+            count += Math.floor(Math.random() * 3) - 1;
+            visitorCounter.textContent = count.toLocaleString() + ' Active Visitors';
+        }, 5000);
+    }
+
+    // Form submission handling
+    const forms = document.querySelectorAll('form');
+    forms.forEach(form => {
+        form.addEventListener('submit', function(e) {
+            e.preventDefault();
+            const submitButton = form.querySelector('button[type="submit"]');
+            if (submitButton) {
+                const originalText = submitButton.textContent;
+                submitButton.innerHTML = '<i data-feather="loader" class="animate-spin mr-2 w-4 h-4"></i> Processing...';
+                feather.replace();
+                
+                // Simulate API call
+                setTimeout(() => {
+                    submitButton.textContent = originalText;
+                    // Show success message
+                    alert('Form submitted successfully!');
+                }, 1500);
+            }
+        });
+    });
+
+    // Mobile menu toggle (if exists)
+    const mobileMenuButton = document.getElementById('mobile-menu-button');
+    const mobileMenu = document.getElementById('mobile-menu');
+    if (mobileMenuButton && mobileMenu) {
+        mobileMenuButton.addEventListener('click', () => {
+            mobileMenu.classList.toggle('hidden');
+        });
+    }
+
+    // Smooth scrolling for anchor links
+    document.querySelectorAll('a[href^="#"]').forEach(anchor => {
+        anchor.addEventListener('click', function(e) {
+            e.preventDefault();
+            document.querySelector(this.getAttribute('href')).scrollIntoView({
+                behavior: 'smooth'
+            });
+        });
+    });
+
+    // Initialize all feather icons
+    feather.replace();
+});
+
+// Debounce function for resize/scroll events
+function debounce(func, wait = 20, immediate = true) {
+    let timeout;
+    return function() {
+        const context = this, args = arguments;
+        const later = function() {
+            timeout = null;
+            if (!immediate) func.apply(context, args);
+        };
+        const callNow = immediate && !timeout;
+        clearTimeout(timeout);
+        timeout = setTimeout(later, wait);
+        if (callNow) func.apply(context, args);
+    };
+}

style.css

@@ -1,28 +1,56 @@
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');
+
 body {
-	padding: 2rem;
-	font-family: -apple-system, BlinkMacSystemFont, "Arial", sans-serif;
+    font-family: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    line-height: 1.6;
+}
+
+/* Custom animations */
+@keyframes fadeIn {
+    from { opacity: 0; transform: translateY(10px); }
+    to { opacity: 1; transform: translateY(0); }
+}
+
+.animate-fade-in {
+    animation: fadeIn 0.5s ease-out forwards;
 }
 
-h1 {
-	font-size: 16px;
-	margin-top: 0;
+/* Custom card hover effect */
+.card-hover:hover {
+    box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
+    transform: translateY(-2px);
+    transition: all 0.3s ease;
 }
 
-p {
-	color: rgb(107, 114, 128);
-	font-size: 15px;
-	margin-bottom: 10px;
-	margin-top: 5px;
+/* Custom button focus state */
+.button-focus:focus {
+    outline: none;
+    box-shadow: 0 0 0 3px rgba(14, 165, 233, 0.5);
 }
 
-.card {
-	max-width: 620px;
-	margin: 0 auto;
-	padding: 16px;
-	border: 1px solid lightgray;
-	border-radius: 16px;
+/* Responsive typography */
+@media (min-width: 1024px) {
+    .text-responsive {
+        font-size: 1.125rem;
+    }
 }
 
-.card p:last-child {
-	margin-bottom: 0;
+/* Custom scrollbar */
+::-webkit-scrollbar {
+    width: 8px;
+    height: 8px;
 }
+
+::-webkit-scrollbar-track {
+    background: #f1f1f1;
+}
+
+::-webkit-scrollbar-thumb {
+    background: #888;
+    border-radius: 4px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+    background: #555;
+}