Déployer Storybook et le site bêta
Le nouveau front se publie en deux projets Vercel, à côté de ceux qui existent déjà (clair-prod pour clair.vote, clair-docs-prod pour docs.clair.vote) :
| Adresse | Application | Contenu |
|---|---|---|
| storybook.clair.vote | apps/storybook | l'atelier des composants : toutes les variantes, en clair, en sombre et sur chaque taille d'écran |
| beta.clair.vote | apps/site | le nouveau site, non indexé tant que la bêta dure |
Les deux applications vivent dans le monorepo pnpm : Vercel installe les dépendances à la racine, puis construit l'application de son dossier. Chacune porte son vercel.json.
Avant de commencer
- Un accès propriétaire à l'équipe Vercel de CLAIR et à la zone DNS de
clair.vote. - La branche du nouveau front fusionnée dans
master. On peut aussi publier une branche de prévisualisation pour essayer. - pnpm 12 : Vercel choisit sa version de pnpm d'après le lockfile, sauf si la variable
ENABLE_EXPERIMENTAL_COREPACK=1est définie. Avec elle, Vercel litpackageManager(pnpm@12.15.0) dans lepackage.jsonracine. Elle est obligatoire sur les deux projets, et aussi surclair-prodetclair-docs-proddepuis le passage du dépôt à pnpm 12.
1. Storybook sur storybook.clair.vote
Créer le projet
- Dans Vercel, Add New → Project, puis importer le dépôt
accelaire/CLAIR. - Project Name :
clair-storybook. - Root Directory :
apps/storybook. Laisser cochée l'option qui inclut les fichiers hors de ce dossier : Vercel a besoin de la racine du monorepo (pnpm-workspace.yaml,packages/*). - Framework Preset :
Other.apps/storybook/vercel.jsonfixe le reste :- commande de build :
pnpm build(soitstorybook build -o storybook-static) ; - dossier publié :
storybook-static.
- commande de build :
- Node.js Version :
24.x. - Environment Variables :
ENABLE_EXPERIMENTAL_COREPACK=1, sur tous les environnements. - Deploy. Le premier build dure quelques minutes. Il se vérifie sur l'adresse
*.vercel.appdu projet : l'introduction s'affiche, et le menu liste « Fondations » et « Composants ».
Storybook est un site statique : il n'appelle pas l'API, et il n'a besoin d'aucun secret. Les images servies (/logo.png…) viennent de apps/site/public (staticDirs de .storybook/main.ts).
Brancher le domaine
-
Dans le projet, Settings → Domains → Add :
storybook.clair.vote. -
Dans la zone DNS de
clair.vote, ajouter l'enregistrement que Vercel affiche, en général :Code -
Attendre que Vercel affiche le domaine comme valide. Le certificat HTTPS est automatique.
Vérifier
https://storybook.clair.votes'ouvre sur l'introduction.- Les liens « Toutes les variantes dans l'atelier Storybook » des pages de composants de docs.clair.vote mènent à la bonne page (exemple : Badge).
- Le thème sombre et les tailles d'écran se choisissent dans la barre d'outils.
Chaque push sur master redéploie l'atelier. Les pull requests reçoivent une prévisualisation, que l'on peut joindre aux captures d'une revue de composant.
2. Le nouveau site sur beta.clair.vote
Créer le projet
-
Add New → Project, même dépôt.
-
Project Name :
clair-site-beta. -
Root Directory :
apps/site. Inclure les fichiers hors de ce dossier. -
Framework Preset :
Next.js. Le build est celui par défaut (next build).apps/site/vercel.jsonfixe la région (cdg1, Paris, comme clair.vote) et les en-têtes de sécurité. -
Node.js Version :
24.x. -
Environment Variables (détail dans
apps/site/README.md) :Variable Valeur Environnements ENABLE_EXPERIMENTAL_COREPACK1tous NEXT_PUBLIC_SITE_URLhttps://beta.clair.voteProduction NEXT_PUBLIC_API_URLhttps://api.clair.votetous CLAIR_INTERNAL_SECRETle secret partagé avec l'API (le même que clair-prod)tous, en Sensitive NEXT_PUBLIC_PLAUSIBLE_DOMAINle site Plausible de la bêta (absent : aucune mesure) Production NEXT_PUBLIC_PLAUSIBLE_SCRIPT_URLShttps://stats.clair.vote/js/script.jsProduction Ne pas définir
SITE_INDEXABLEpendant la bêta. Sans elle,robots.txtinterdit l'indexation et chaque page portenoindex: la bêta ne fait pas concurrence à clair.vote dans les moteurs de recherche.Les variables
NEXT_PUBLIC_*sont figées au build : après un changement, relancer un déploiement. -
Deploy. Le build ne dépend pas de l'API : si elle est injoignable, le plan du site est réduit aux pages statiques et l'erreur est journalisée.
Brancher le domaine
-
Settings → Domains → Add :
beta.clair.vote. -
Dans la zone DNS :
Code
Vérifier
https://beta.clair.voteaffiche l'accueil, et/deputes,/scrutinset/senatoriales-2026répondent avec des données.https://beta.clair.vote/robots.txtinterdit tout (Disallow: /).https://beta.clair.vote/sitemap.xmlliste des adresses enhttps://beta.clair.vote/….- Le formulaire de retour envoie bien (
POST /api/v1/feedbackdans l'onglet Réseau, réponse 200 ou 201). - Dans le tableau de bord de l'API, les appels de la bêta arrivent comme trafic interne : c'est le secret
CLAIR_INTERNAL_SECRET, posé par le serveur du site et jamais par le navigateur.
3. Après la bêta : bascule de clair.vote
Quand le nouveau site remplace l'ancien :
- Dans
clair-site-beta, passerNEXT_PUBLIC_SITE_URLàhttps://clair.voteet définirSITE_INDEXABLE=true. - Déplacer le domaine
clair.vote(etwww) declair-prodvers ce projet, puis redirigerbeta.clair.voteversclair.vote. - Redéployer, puis vérifier
robots.txt,sitemap.xmlet les adresses canoniques. - Garder
clair-prod(apps/web) quelques jours, prêt à reprendre le domaine, puis le supprimer avecapps/web.
En cas de problème
| Symptôme | Cause probable | Remède |
|---|---|---|
ERR_PNPM_UNSUPPORTED_ENGINE, ou une installation avec pnpm 9 ou 10 | ENABLE_EXPERIMENTAL_COREPACK absente | la définir à 1, puis redéployer |
ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION | une dépendance publiée il y a moins d'un jour | attendre, ou l'exclure dans minimumReleaseAgeExclude (pnpm-workspace.yaml), en datant l'exclusion |
Storybook : page blanche, 404 sur les fichiers | dossier publié incorrect | Output Directory = storybook-static, avec le Root Directory sur apps/storybook |
Site bêta : listes vides, erreurs [api-server] dans les journaux | NEXT_PUBLIC_API_URL ou CLAIR_INTERNAL_SECRET absents ou faux | corriger, puis redéployer (les NEXT_PUBLIC_* sont figées au build) |
| Site bêta indexé par les moteurs | SITE_INDEXABLE=true défini trop tôt | le retirer, puis redéployer |