Astro : poser les règles avant les pages, puis publier
Le parcours complet, dépôt privé compris : le système de design d’abord, l’implémentation ensuite, puis la mise en ligne automatique à chaque push. Avec les cinq pièges qui m’ont fait perdre du temps, faute de figurer dans la documentation.
Deux outils, deux étapes. Claude Design sert à fixer les règles : tokens de couleur et d’espacement, surfaces, ce que la marque s’interdit. Claude Code sert à les appliquer. Séparer les deux permet ensuite de juger une page sur une règle écrite.
Le système est livré sous forme de variables CSS et d’un fichier de règles. Le second est le plus utile, car il liste ce qui est interdit : aucune valeur hexadécimale en dur, aucune ombre portée, aucun arrondi de bordure. Un script de vérification parcourt tout le dépôt et bloque la construction en cas d’écart. Il a déjà rejeté du code que j’avais écrit moi-même, ce qui montre qu’il fonctionne.
// package.json — the repository's front door
{
"scripts": {
"check": "astro check",
"adherence": "node scripts/check-adherence.mjs",
"verify": "npm run check && npm run adherence && npm run build"
}
}En sortie statique, Astro ne produit que du HTML, du CSS et quelques kilo-octets de script. Il n’y a pas de rendu serveur, donc rien à maintenir en production : la page servie est celle qui a été construite. C’est ce qui rend l’hébergement presque gratuit et la reprise possible par quelqu’un d’autre.
Le dépôt est privé, le site public. GitHub Actions construit le site, puis envoie le dossier produit vers Cloudflare Pages. Deux secrets suffisent : un jeton d’API et l’identifiant du compte. Le déploiement dépend de la vérification, et rien n’est publié si une règle du système est enfreinte.
- name: Verify
run: npm run verify
working-directory: site
- name: Publish to Cloudflare Pages
if: github.event_name != 'pull_request'
uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
workingDirectory: site
command: pages deploy dist --project-name=preview-commutator --branch=main- On ne peut pas ajouter l’intégration Git à un projet Pages existant. Un projet créé pour l’envoi direct le reste : il faut le recréer, ou le piloter depuis Actions, comme le fait ce site.
- L’action wrangler découpe la commande sur les espaces. Une option contenant un message sur plusieurs lignes la casse, et le message d’erreur n’aide pas. La commande doit tenir sur une seule ligne d’arguments simples.
- Cloudflare ajoute un suffixe au sous-domaine du projet, si bien que le nom choisi ne donne pas l’adresse attendue. Il faut lire l’adresse réelle au lieu de la déduire.
- Un domaine personnalisé ne se configure pas seulement dans le DNS. Tant qu’il n’est pas rattaché au projet dans Cloudflare, la résolution fonctionne mais le certificat échoue, ce qui fait chercher la cause au mauvais endroit.
- Le cache périphérique conserve longtemps les pages. Une page renommée a continué d’être servie une semaine après sa suppression, avec un cache-control d’une semaine et un statut « HIT ». Supprimer une route n’efface pas ce cache, et il faut une redirection explicite.
# public/_redirects — old addresses go straight to the final destination,
# not chained one into the next
/journal/* /points-de-vue/:splat 301
/journal /points-de-vue 301Le nom de domaine seulement. L’offre gratuite de Pages suffit largement pour un site de cette taille, et GitHub Actions ne facture ni les dépôts publics ni les petits volumes. Le principal investissement est ailleurs : les règles écrites au départ prennent une journée et évitent des semaines de reprises.