← points de vue
29 juillet 2026

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.

01la règle avant la page

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.

json
// 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"
  }
}
02une sortie entièrement statique

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.

03le dépôt reste privé

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.

yaml
- 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
04les cinq pièges
  • 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.
plaintext
# 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         301
05ce que ça coûte

Le 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.