Dépendances du projet

Ce document liste les librairies déclarées dans package.json : ce qu'elles font, et pourquoi elles sont utilisées ici précisément (pas juste leur description générique).

Framework

• next — Le framework lui-même : App Router, rendu statique (app/page.tsx est entièrement prérendu), optimisation d'images (next/image, utilisé pour le portrait dans le header) et de polices (next/font/google), et les conventions de fichiers pour le SEO (app/robots.ts, app/sitemap.ts, app/opengraph-image.tsx, l'API Metadata dans app/layout.tsx).
• react / react-dom — Dépendances requises par Next.js ; la librairie UI sous-jacente.

Style

• tailwindcss — Utilitaire CSS utilisé pour la quasi-totalité du style du site, ainsi que le système de tokens (@theme dans app/globals.css : couleurs, polices, échelle typographique dédiée à la feuille CV imprimée).
• @tailwindcss/postcss — Plugin PostCSS qui compile Tailwind v4 (remplace l'ancien tailwind.config.js des versions précédentes de Tailwind).
• postcss — Moteur de transformation CSS requis pour faire tourner le plugin ci-dessus (postcss.config.mjs).

Utilitaires UI

• class-variance-authority — Gère les variantes de className de façon typée. Utilisé dans components/ui/button.tsx pour définir les variantes solid/outline et les tailles md/sm du bouton sans empiler des conditions manuelles.
• clsx — Concatène des classNames conditionnellement. Utilisé dans lib/utils.ts comme brique de base du helper cn().
• tailwind-merge — Résout les classes Tailwind en conflit (ex. deux px-* différents) en gardant la dernière plutôt que de les empiler bêtement. Combiné à clsx dans cn(), ça permet à n'importe quel composant (ex. SectionLabel) d'accepter un prop className qui surcharge proprement ses classes par défaut.
• lucide-react — Bibliothèque d'icônes. Utilisée pour l'icône d'impression dans components/ui/print-button.tsx.

Documentation (/docs)

• react-markdown — Rend le Markdown en React côté serveur : les fichiers de docs/, les articles du blog et l'aperçu de l'éditeur admin, tous via le composant partagé components/markdown.tsx. Sans dangerouslySetInnerHTML (tout le contenu est écrit par le propriétaire du site, mais autant éviter l'injection de HTML brut par principe).
• remark-gfm — Plugin de react-markdown qui ajoute la syntaxe GitHub : surtout les tableaux (sans lui, ils sortent comme un paragraphe de | — par exemple dans docs/blog-content-format.md), mais aussi le texte barré, les liens automatiques et les listes de tâches. Branché une seule fois, dans components/markdown.tsx.
• @tailwindcss/typography — Fournit les classes prose pour une mise en forme lisible du Markdown rendu (titres, listes, liens) sans styliser chaque balise à la main. Activé via @plugin "@tailwindcss/typography"; dans app/globals.css.

Blog & admin (voir docs/adr/0011-blog-admin-architecture.md)

• next-auth (@beta, Auth.js v5) — Authentification de la zone /admin, via le provider LinkedIn, restreint au seul profil du propriétaire du site. Stratégie de session en JWT, sans adaptateur de base de données.
• @octokit/rest — Client de l'API GitHub (Contents API), utilisé côté serveur uniquement par les server actions de l'admin pour committer/mettre à jour les fichiers Markdown des articles dans ce repo.
• gray-matter — Parsing et génération du frontmatter YAML des fichiers content/blog/*.md (titre, date, tags, statut brouillon/publié), consommé par lib/blog.ts.

Qualité de code & outillage

• typescript — Typage statique sur l'ensemble du code.
• eslint — Linter.
• eslint-config-next — Le ruleset ESLint officiel de Next.js (règles Core Web Vitals, hooks React, etc.). Depuis la v16, il expose directement des configs plates (eslint-config-next/core-web-vitals, eslint-config-next/typescript) consommées telles quelles dans eslint.config.mjs — plus besoin de couche de compatibilité .eslintrc.
• eslint-plugin-jsx-a11y — N'était jusqu'ici qu'une dépendance transitive d'eslint-config-next (6 règles en warn), non résolvable directement depuis la racine. Déclarée en dépendance directe pour pouvoir importer son preset strict (33 règles, en erreur) dans eslint.config.mjs — voir docs/adr/0016-accessibility-strategy.md.
• playwright — Pilote un navigateur réel pour scripts/a11y.mjs (pnpm a11y) : charge le site servi à 1280 px et à 320 px, ouvre le menu mobile, parcourt blog/docs/404. N'est utilisé que pour cette vérification, pas comme suite de tests. En CI, le Chromium de Playwright est installé par playwright install chromium ; en local, PLAYWRIGHT_CHANNEL=chrome réutilise le Chrome du système.
• @axe-core/playwright — Intègre axe-core (le moteur de règles WCAG de Deque) à une page Playwright. Détecte ce que eslint-plugin-jsx-a11y ne peut pas voir sur le code seul : landmarks réels, noms accessibles calculés, contraste, zones défilantes sans accès clavier. Voir docs/adr/0016-accessibility-strategy.md.
• prettier — Formateur de code.
• prettier-plugin-tailwindcss — Trie automatiquement les classes Tailwind dans un ordre canonique à l'intérieur des className, pour que les diffs restent lisibles et cohérents peu importe qui édite un composant.
• husky — Gère le hook Git pre-commit (.husky/pre-commit) qui déclenche lint-staged avant chaque commit.
• lint-staged — N'exécute prettier/eslint que sur les fichiers réellement stagés d'un commit (config dans le champ lint-staged de package.json) — c'est ce qui a reformaté automatiquement les fichiers à chaque commit de ce projet.
• @types/node, @types/react, @types/react-dom — Définitions de types TypeScript pour Node.js, React et ReactDOM, aucune de ces trois librairies ne fournissant ses propres types.