C'EST QUOI ?
Starlight est un framework de documentation construit sur Astro. Il fournit tout ce qu'il faut pour publier un site de docs technique propre — navigation, recherche, i18n, thème clair/sombre, coloration syntaxique — sans avoir à recoder à chaque fois la même boilerplate. Tu écris du Markdown, MDX ou Markdoc, Starlight s'occupe du reste.
POURQUOI C'EST INTÉRESSANT ?
- Astro sous le capot : sortie HTML statique, zéro JS côté client par défaut, scores Lighthouse élevés sans effort.
- Recherche intégrée : indexation full-text via Pagefind, raccourci Ctrl+K, aucune configuration externe à brancher.
- i18n natif : structure multi-langues prête à l'emploi, fallback automatique sur la langue par défaut, sélecteur de langue inclus.
- Frontmatter typé : schémas de contenu TypeScript pour valider les métadonnées des pages au build, fini les fautes de frappe silencieuses.
- Composants multi-framework : tu peux insérer du React, Vue, Svelte ou Solid dans tes pages MDX, Astro hydrate uniquement ce qui en a besoin.
- Personnalisable : système de plugins, override de composants, design tokens CSS exposés — facile à plier à une charte graphique existante.
CAS D'USAGE
- Documentation technique d'un projet open source ou interne
- Référence API et guides développeur
- Knowledge base produit avec recherche et multi-langue
- Migration depuis Docusaurus, MkDocs ou VitePress pour gagner en perf