La clé d'un projet structuré
Ce qu'il faut retenir
La configuration d'Astro ne sert pas uniquement a ajuster quelques options. Elle conditionne la qualité du build, la cohérence des intégrations, la facilité de déploiement et la capacité de l'équipe a faire évoluer le projet sans régressions.
Le rôle central de astro.config.mjs
Ce fichier est le centre de commande de votre projet Astro. Il s'agit d'un module ES qui exporte la configuration principale. C'est ici que vous définissez les intégrations, comme les adaptateurs de déploiement, les outils de styling (Tailwind, Sass) et les fonctionnalités complémentaires (sitemap, robots.txt).
Dans un projet professionnel, ce fichier joue surtout un role d'arbitrage technique : il fixe les conventions de build, clarifie les dépendances réellement utiles et évite d'empiler des choix implicites qui deviennent coûteux plus tard.
Personnaliser le build et le déploiement
Le fichier de configuration vous permet de contrôler précisément la construction de votre site. Vous pouvez y spécifier l'URL finale de production, le dossier de sortie (dist par défaut) et surtout choisir un adaptateur. Cet adaptateur dicte a Astro comment compiler le code pour votre environnement cible, qu'il s'agisse d'un hébergement statique, d'un serveur Node.js ou d'une plateforme edge comme Vercel ou Netlify.
Optimisation et intégrations
Les performances sont au cœur d'Astro, et la configuration est là pour les affiner. Vous pouvez activer le rendu hybride, gérer la stratégie de compression des ressources et configurer le préchargement des assets. L'ajout d'intégrations via npm est également centralisé ici, transformant Astro d'un générateur de site statique simple en une plateforme de développement complète et extensible.
Gérer les adaptateurs et le rendu
La configuration détermine aussi le mode de rendu de vos pages. Vous pouvez définir un rendu statique par défaut, activer du server-side rendering (SSR) quand le besoin le justifie et garder une lecture claire de ce qui part au build ou reste dynamique. Le choix de l'adaptateur est crucial pour le SSR, car il fournit le runtime serveur nécessaire. Une mauvaise décision à ce niveau provoque souvent des erreurs de déploiement, de cache ou de compatibilité.
