Toutes les docs

Mis à jour le 2026-10-28

Déploiement

Build, hébergement, domaine et configuration analytics.

Build

Le site est construit en HTML statique au moment du build par Next.js :

pnpm build

Next.js prérend la page d'accueil, les pages de documentation, le sitemap et les assets statiques pour les sept locales au moment du build. Les servir demande quand même un runtime qui exécute le middleware de négociation de locale (apps/web/src/proxy.ts) et les en-têtes de sécurité, donc la cible est Vercel avec le preset Next.js ; un hébergeur purement statique perdrait la négociation de locale.

Hébergement

L'hébergement de production est Vercel :

  • framework preset : Next.js
  • root directory : apps/web
  • build command : pnpm build

Le domaine est ella.yuricunha.com, configuré dans apps/web/src/data/site.ts et les metadata de l'app, qui pilotent les URLs canoniques, l'Open Graph et le sitemap.

Routes de documentation

  • /docs index des pages de documentation, par langue ;
  • /docs/<slug> page individuelle de documentation, par langue.

Ce sont des routes statiques générées au build. La langue par défaut (anglais) n'a pas de préfixe d'URL ; les autres langues portent leur préfixe, par exemple /pt/docs ou /ja/docs.

Routes de localisation

  • Anglais par défaut : https://ella.yuricunha.com
  • Autres langues : https://ella.yuricunha.com/<locale>

Chaque page déclare des alternates hreflang pour les sept langues, et le sitemap liste chaque variante.

Analytics

Umami est préparé mais inerte par défaut. Le composant Analytics ne se rend que lorsque les deux variables d'environnement sont présentes au build :

NEXT_PUBLIC_UMAMI_SRC=https://votre-hote-umami/script.js
NEXT_PUBLIC_UMAMI_WEBSITE_ID=votre-website-id

Sans elles, le site livre zéro JavaScript d'analytics. Aucun ID de placeholder n'est committé.

Portes de qualité

Aucun serveur de CI ne surveille les pushes : les pipelines GitLab ont été retirés et le dépôt GitLab n'est qu'un miroir. Lancez les portes avant le push :

pnpm type-check && pnpm lint && pnpm test && pnpm format:check && pnpm build

pnpm audit --prod doit aussi revenir propre. Vercel construit le bundle de production au déploiement ; comme les pages sont prérendues, un build vert est la porte.

SEO

  • metadata, Open Graph, Twitter cards, canonical et JSON-LD dans le layout de la locale ;
  • robots.txt et le sitemap sont générés dans le build ;
  • la social card est public/og.png (1200x630, générée avec les polices Geist à partir d'un template HTML rendu) ;
  • chaque langue reçoit ses propres metadata et alternates hreflang.