Build et déploiement | Lisible Documentation

Lisible produit un dossier dist/ autonome. Aucun serveur Node ou Bun n’est nécessaire pour servir la production : un hébergeur statique ou un CDN suffit.¹

Build de référence

bun run build

La commande valide le contenu, génère les routes FR/EN, les images OpenGraph, le sitemap, les flux, les exports Markdown puis l’index Pagefind.

Diagramme100%
Rendu du diagramme...
Molette pour zoomer, glisser pour deplacer
flowchart TD
  Q[Contrôles de contenu] --> A[astro build]
  A --> R[Routes statiques]
  A --> O[Images OG]
  R --> P[Index Pagefind]
  O --> D[dist/]
  P --> D
  D --> C[CDN / hébergeur statique]

Variables de production

Avant le build, vérifiez dans lisible.config.json :

site.url avec le domaine final ;
l’objet repo pour les liens d’édition ;
les configurations publiques Giscus, Bluesky ou webmention.io sous integrations ;
les secrets injectés par l’environnement, jamais écrits dans le client ;
la variant choisie, ou une variable d’environnement LISIBLE_VARIANT sur la plateforme pour la surcharger sans éditer le fichier.

Stratégies d’hébergement

Plateforme	Sortie	Réécritures
GitHub Pages	`dist/`	base path éventuel
Cloudflare Pages	`dist/`	aucune pour les routes générées
Netlify	`dist/`	page 404 statique
Vercel	`dist/`	projet statique
Nginx/Caddy	fichiers `dist/`	fallback 404, compression

Déploiement en un clic

Le README racine place côte à côte les boutons Deploy with Vercel et Deploy to Netlify ; vercel.json et netlify.toml préconfigurent les deux. Importez le dépôt à sa racine : chaque configuration de plateforme construit la variante choisie dans lisible.config.json (ou par LISIBLE_VARIANT) et publie le dossier dist/ mis en miroir, sans configuration manuelle dans le tableau de bord.

Railpack détecte automatiquement railpack.json et Staticfile, Nixpacks détecte nixpacks.toml, et le PORT fourni par la plateforme est utilisé automatiquement. Les outils d’exécution sont épinglés en version, Nixpacks vérifie la somme de contrôle de chaque artefact Node, Bun et Caddy téléchargé, et seuls le site compilé et son runtime Caddy atteignent l’image finale : elle sert les routes statiques directement, compresse les réponses, met en cache un an les assets empreintés et rend la page 404 du projet pour les routes inconnues.

En-têtes recommandés

cache long et immutable pour /_astro/* ;
cache court pour HTML, RSS, sitemap et Pagefind ;
Content-Security-Policy adaptée aux intégrations activées ;
compression Brotli ou gzip ;
X-Content-Type-Options: nosniff et politique de referrer.

Recette après déploiement

Ouvrez une page FR et son miroir EN.
Vérifiez canonical, hreflang et image OG.
Testez Ctrl/Cmd + K.
Naviguez sans rechargement complet.
Ouvrez RSS, sitemap, robots.txt et llms.txt.
Contrôlez une 404 réelle.

La page Qualité et accessibilité donne la checklist avant publication.

Références

Footnotes

Le mode statique est le comportement par défaut d’Astro ; Lisible le fixe explicitement pour rendre l’artefact prévisible. ↩