diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..b7a7bc9
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,313 @@
+<!-- GSD:project-start source:PROJECT.md -->
+## Project
+
+**Portfolio Killian Dalcin — Migration Nuxt 4**
+
+Migration complète d'un portfolio freelance de Vue 3 SPA vers Nuxt 4 avec SSR complet. Le site présente les projets, services et compétences de Killian Dalcin, développeur freelance, avec support bilingue FR/EN. L'objectif est un SEO parfait et un développement rapide via des composants prêts à l'emploi (Nuxt UI v3).
+
+**Core Value:** Chaque page du portfolio doit être crawlable par les moteurs de recherche sans JavaScript côté client — le SSR est la raison d'être de cette migration.
+
+### Constraints
+
+- **Stack**: Nuxt 4 + Nuxt UI v3 + Tailwind v4 — dernières versions stables
+- **Coût**: Zéro dépendance payante
+- **Composants**: Nuxt UI v3 en priorité sur le custom (80% suffit)
+- **TypeScript**: Mode strict partout
+- **Déploiement**: Docker node:22-alpine, nuxt build (SSR) ou nuxt generate (SSG) selon stratégie
+- **i18n/Theme**: Persistance cookie uniquement (SSR-safe), pas de localStorage
+<!-- GSD:project-end -->
+
+<!-- GSD:stack-start source:codebase/STACK.md -->
+## Technology Stack
+
+## Languages
+- TypeScript ~5.8.0 - Full application development
+- JavaScript (ES modules) - Frontend runtime
+- HTML5 - Document structure (in `index.html`)
+- CSS - Styling with Tailwind CSS
+- Markdown - Documentation (README.md)
+- YAML - Configuration (implied through Dockerfile)
+## Runtime
+- Node.js 22 - Development and build environment
+- Browser environment - Vue 3 SFC runtime
+- npm - Dependency management
+- Lockfile: `package-lock.json` (present and tracked)
+## Frameworks
+- Vue 3.5.13 - Progressive JavaScript framework for UI
+- Vue Router 4.5.0 - Client-side routing with lazy-loaded pages
+- Pinia 3.0.1 - State management (minimal usage - currently only `counter.ts`)
+- Vue I18n 9.14.4 - Internationalization (English and French locale files in `src/locales/`)
+- Vite 6.2.4 - Build tool and dev server
+- Vite Plugin Vue DevTools 7.7.2 - Development utilities
+- @vitejs/plugin-vue 5.2.3 - Vue 3 SFC support
+- Tailwind CSS 4.1.10 - Utility-first CSS framework
+- @tailwindcss/postcss 4.1.10 - PostCSS plugin for Tailwind
+- PostCSS 8.5.6 - CSS transformation pipeline
+- Autoprefixer 10.4.21 - Vendor prefix handling
+- Terser 5.43.1 - JavaScript minification
+- ESLint 9.22.0 - Linting (config: `eslint.config.ts`)
+- Prettier 3.5.3 - Code formatting (config: `.prettierrc.json`)
+- vue-tsc 2.2.8 - Vue component type checking
+- TypeScript compiler with `type-check` npm script
+- @vueuse/head 2.0.0 - Dynamic document head management for meta tags and SEO
+## Key Dependencies
+- vue 3.5.13 - Core framework
+- vue-router 4.5.0 - SPA routing with code splitting
+- pinia 3.0.1 - State management store
+- vue-i18n 9.14.4 - Multi-language support
+- vite 6.2.4 - Next-gen build tool with HMR
+- tailwindcss 4.1.10 - Rapid UI development
+- typescript 5.8.0 - Static typing and compilation
+- eslint 9.22.0 - Code linting
+- prettier 3.5.3 - Code formatting
+- npm-run-all2 7.0.2 - Parallel script execution (used in build process)
+- @tsconfig/node22 22.0.1 - TSConfig preset for Node 22
+- @types/node 22.14.0 - Node.js type definitions
+- jiti 2.4.2 - CommonJS loader for TypeScript modules
+## Configuration
+- No `.env` files detected in source
+- Google Analytics tracking ID hardcoded: `G-CDVVNFY6MV` (in `index.html`)
+- Umami analytics script loaded from `umami.killiandalcin.fr` (in `index.html`)
+- Google AdSense client ID hardcoded: `ca-pub-5219367964457248` (in `index.html`)
+- `vite.config.ts` - Build optimizations:
+- `tsconfig.json` - References `tsconfig.app.json` and `tsconfig.node.json`
+- `tsconfig.app.json`:
+- `eslint.config.ts` - Flat config format:
+- `.prettierrc.json`:
+- `postcss.config.js` - Tailwind CSS and Autoprefixer
+- `tailwind.config.js` - Content scanning for `index.html` and `src/**/*.{vue,js,ts,jsx,tsx}`
+## Platform Requirements
+- Node.js 22+ (specified in Dockerfile)
+- npm 10+ (implied by Node 22)
+- TypeScript 5.8+
+- Any Unix-like shell (bash/zsh) or Windows with Node.js
+- Docker - Multi-stage build with Node 22-alpine and nginx stable-alpine
+- Web server: nginx (configured in `nginx.conf`)
+- Deployment target: Static HTML served via nginx
+- JavaScript enabled (noscript fallback message in `index.html`)
+- Modern browsers with ES2020+ support (Vite default targets)
+## Scripts & Commands
+<!-- GSD:stack-end -->
+
+<!-- GSD:conventions-start source:CONVENTIONS.md -->
+## Conventions
+
+## Naming Patterns
+- Vue components: PascalCase (e.g., `AppHeader.vue`, `ProjectCard.vue`)
+- Composables: camelCase with `use` prefix (e.g., `useTheme.ts`, `useProjects.ts`)
+- Utility/config files: camelCase (e.g., `site.ts`, `techstack.ts`)
+- Data files: camelCase (e.g., `testimonials.ts`, `faq.ts`)
+- Type definitions: camelCase in `types/index.ts`
+- All functions use camelCase (e.g., `toggleTheme`, `openGallery`, `getImageUrl`)
+- Composables are named with `use` prefix: `useTheme()`, `useGallery()`, `useSeo()`
+- Getter functions use `get` prefix: `getTheme()`, `getImageUrl()`
+- Boolean functions/computed use `is`/`has` prefix: `isDark`, `hasNext`, `isOpen`
+- Handler functions use verb + `Handler`: `toggleTheme`, `openGallery`, `closeGallery`
+- Refs and computed properties: camelCase (e.g., `isDark`, `currentIndex`, `isOpen`)
+- Interfaces and types: PascalCase (e.g., `Props`, `SeoOptions`, `Theme`)
+- Constants: UPPER_SNAKE_CASE for config constants (not extensively used in codebase)
+- Private/module state: camelCase prefixed with `_` if truly private
+- Type aliases: PascalCase (e.g., `type Theme = 'light' | 'dark'`)
+- Interface names: PascalCase (e.g., `interface Props`, `interface SeoOptions`)
+- Props interfaces: Always named `Props` (e.g., in `<script setup lang="ts">` components)
+- Generic types from Vue use their original names (e.g., `Ref<boolean>`, `Computed<string>`)
+## Code Style
+- Tool: Prettier 3.5.3
+- Semi-colons: **disabled** (`semi: false`)
+- Quotes: **single quotes** (`singleQuote: true`)
+- Print width: **100 characters** (`printWidth: 100`)
+- Tool: ESLint 9.22.0 with Vue support
+- Config: `eslint.config.ts` using flat config format
+- Plugins: 
+## Import Organization
+- `@/` maps to `./src/` (configured in `tsconfig.app.json`)
+- Always use `@/` prefix for imports from src directory
+- Examples:
+## Error Handling
+- Try-catch blocks wrap risky operations (e.g., dynamic imports, DOM manipulation)
+- Fallback values provided when operations fail:
+- Console warnings for non-critical failures:
+- Silent failures with fallbacks preferred over throwing errors for UI operations
+## Logging
+- `console.warn()` for warnings (missing assets, invalid input)
+- Logging only in composables for utility functions
+- No console.log() in production code (only development/debugging)
+- Error context included: `console.warn('context', error)`
+## Comments
+- JSDoc comments for composable functions (exported functions)
+- Inline comments for non-obvious logic (especially SEO handling in router)
+- Comments explaining why (not what the code does)
+- TODO comments for known issues: `// TODO: page 404` in `src/router/index.ts`
+- Composables include JSDoc for exported functions
+- Example from `useAssets.ts`:
+- Not consistently applied across all files; use when function signature isn't obvious
+## Function Design
+- Props interfaces always named `Props` in components
+- Use destructuring in setup: `const { t } = useI18n()`
+- Optional config objects in composables (e.g., `SeoOptions` with defaults)
+- Explicit typing on all parameters
+- Composables return object with all exposed functions and reactive state
+- Always return computed versions of reactive state when exposing refs:
+- Functions return early on validation failures with fallbacks
+## Module Design
+- Composables export single named function: `export function useTheme() { ... }`
+- Config files export named constants: `export const siteConfig: SiteConfig = { ... }`
+- Type definitions export interfaces and types: `export interface Project { ... }`
+- Data files export arrays or objects: `export const techStack: TechStack = { ... }`
+- Not extensively used; direct imports preferred
+- Only `src/types/index.ts` serves as barrel export for type definitions
+- Components use direct imports: `import AppHeader from '@/components/layout/AppHeader.vue'`
+- `<script setup lang="ts">` for all components (Vue 3 Composition API)
+- Props validated with TypeScript interfaces
+- Composables called at top of setup
+- Computed properties for derived state
+- Functions defined after setup calls
+- `<template>` uses semantic HTML and accessibility attributes
+- Scoped styles at bottom with `@import` for external stylesheets
+## Type Safety
+- Version: ~5.8.0
+- DOM-focused (`tsconfig.dom.json` from @vue/tsconfig)
+- Path alias `@/*` points to `./src/*`
+- Type checking enabled in build: `npm run type-check` runs `vue-tsc --build`
+- All component Props use interface definitions
+- Composable return values typed explicitly
+- Function parameters and return types annotated
+- Type imports use `import type` syntax
+- Avoid `any` type; use proper interfaces/generics
+## Vue 3 Specific
+- `<script setup>` syntax exclusively used
+- No Options API in codebase
+- Composables follow Composition API patterns
+- `onMounted()` for initialization (theme loading, SEO setup)
+- `onUnmounted()` for cleanup (removing DOM elements in useSeo)
+- `watch()` for reactive side effects (theme changes)
+- `ref()` for primitive state
+- `computed()` for derived state
+- Avoid unnecessary reactivity; use constants when possible
+- Return computed versions of refs from composables
+<!-- GSD:conventions-end -->
+
+<!-- GSD:architecture-start source:ARCHITECTURE.md -->
+## Architecture
+
+## Pattern Overview
+- Client-side routing with lazy-loaded views for performance optimization
+- Composition API-based composables for shared logic and state management
+- Global state managed via Pinia stores
+- Multi-language support with vue-i18n
+- Theme switching with localStorage persistence
+- SEO-optimized with dynamic meta tags and structured data
+- Google Analytics and GTM integration for tracking
+## Layers
+- Purpose: Render UI and handle user interactions
+- Location: `src/components/`
+- Contains: Vue Single File Components organized by domain (layout, sections, shared, testimonials, icons)
+- Depends on: Composables for data access and side effects, Router for navigation
+- Used by: Views and other components
+- Purpose: Page-level component assembly and routing targets
+- Location: `src/views/`
+- Contains: Full page components (HomePage, ProjectsPage, ContactPage, AboutPage, FiverrPage, FormationPage, ProjectDetailPage)
+- Depends on: Composables (useSeo, useI18n, useProjects), components, data stores
+- Used by: Router for navigation
+- Purpose: Encapsulate reusable logic, data fetching, and side effects
+- Location: `src/composables/`
+- Contains: Vue composables for projects, SEO, i18n, themes, galleries, date formatting, assets, site config
+- Depends on: Types, stores, external libraries (vue-router, vue-i18n)
+- Used by: Components and views
+- Purpose: Global state and static data management
+- Location: `src/stores/`, `src/data/`
+- Contains: Pinia stores, static project data, testimonials, tech stack, FAQs
+- Depends on: Types, composables (useI18n for localized data)
+- Used by: Composables and components
+- Purpose: Application-wide settings and configuration
+- Location: `src/config/`, `src/router/`, `src/i18n/`
+- Contains: Site configuration, router setup, i18n initialization, locale messages
+- Depends on: Types, data
+- Used by: Main entry point and throughout app
+- Purpose: TypeScript interfaces and types
+- Location: `src/types/index.ts`
+- Contains: Project, Technology, TechStack, SocialLink, ContactInfo, FiverrService, SiteConfig interfaces
+## Data Flow
+- **Global:** Pinia stores (currently minimal - `useCounterStore` exists but unused)
+- **Composable State:** Reactive refs in composables (theme, locale, gallery state)
+- **Component State:** Local reactive refs for UI state (menu toggle, form inputs)
+- **Persistence:** localStorage for theme and locale preferences
+- **Server-Side Data:** Static JSON-like data in `src/data/` files, not fetched from API
+## Key Abstractions
+- Purpose: Unified i18n access with convenience methods
+- Examples: `src/composables/useI18n.ts`
+- Pattern: Wraps vue-i18n's `useI18n()`, adds locale switching and computed locale state
+- Usage: Available in all components via injection
+- Purpose: Dynamic SEO tag management for SPA
+- Examples: `src/composables/useSeo.ts`
+- Pattern: Lifecycle hooks to create/remove meta tags on mount/unmount, prevents tag duplication
+- Usage: Called in view components with options object for title, description, OG tags, structured data
+- Purpose: Project data access with localization
+- Examples: `src/composables/useProjects.ts`
+- Pattern: Base data stored separately, computed properties merge translations on read
+- Usage: Returns computed `projects` array that updates when language changes
+- Purpose: Centralized theme state and persistence
+- Examples: `src/composables/useTheme.ts`
+- Pattern: Reactive boolean with computed getter, watch for persistence, DOM manipulation
+- Usage: Injected globally in App.vue, consumed by ThemeToggle component
+- Purpose: Typed structure for technology categories
+- Examples: `src/types/index.ts`
+- Pattern: Categorized array structure (programming, front, database, devtools, operating_systems, socials)
+- Usage: Imported in `src/data/techstack.ts` and AboutPage.vue
+- Purpose: Single source of truth for site-wide settings
+- Examples: `src/config/site.ts`
+- Pattern: Exported constant object with typed structure, includes contact info, social links, SEO config
+- Usage: Imported where needed for links, contact info, performance settings
+## Entry Points
+- Location: `index.html`
+- Triggers: Browser page load
+- Responsibilities: Define DOM root (`#app`), load analytics/ads scripts, include meta tags, defer main.ts loading
+- Location: `src/main.ts`
+- Triggers: After HTML DOM ready
+- Responsibilities: Create Vue app, install plugins (Pinia, Router, i18n), mount to #app
+- Location: `src/router/index.ts`
+- Triggers: App.use(router) in main.ts
+- Responsibilities: Define route table, implement beforeEach/afterEach hooks for SEO and analytics
+- Location: `src/App.vue`
+- Triggers: After Vue app mounts
+- Responsibilities: Initialize theme, render layout structure (header + router-view + footer), handle route-change scroll behavior
+- Location: `src/views/*.vue`
+- Triggers: Router navigation to matching path
+- Responsibilities: Page-specific SEO setup via `useSeo()`, compose sections and content, manage page-level state
+## Error Handling
+- Lazy-loaded routes with no 404 component (TODO comment in router) - currently redirects to HomePage
+- SEO composable safely creates/finds meta elements before updating
+- Theme fallback to 'dark' if localStorage empty
+- Locale fallback to 'en' if not in localStorage
+- Gallery modal (GalleryModal.vue) handles missing images gracefully
+- Contact form likely has validation but not visible in read scope
+## Cross-Cutting Concerns
+<!-- GSD:architecture-end -->
+
+<!-- GSD:skills-start source:skills/ -->
+## Project Skills
+
+No project skills found. Add skills to any of: `.claude/skills/`, `.agents/skills/`, `.cursor/skills/`, or `.github/skills/` with a `SKILL.md` index file.
+<!-- GSD:skills-end -->
+
+<!-- GSD:workflow-start source:GSD defaults -->
+## GSD Workflow Enforcement
+
+Before using Edit, Write, or other file-changing tools, start work through a GSD command so planning artifacts and execution context stay in sync.
+
+Use these entry points:
+- `/gsd-quick` for small fixes, doc updates, and ad-hoc tasks
+- `/gsd-debug` for investigation and bug fixing
+- `/gsd-execute-phase` for planned phase work
+
+Do not make direct repo edits outside a GSD workflow unless the user explicitly asks to bypass it.
+<!-- GSD:workflow-end -->
+
+
+
+<!-- GSD:profile-start -->
+## Developer Profile
+
+> Profile not yet configured. Run `/gsd-profile-user` to generate your developer profile.
+> This section is managed by `generate-claude-profile` -- do not edit manually.
+<!-- GSD:profile-end -->