BLUME 2.0 : des docs qui parlent aux humains et aux agents
«
https://x.com/haydenbleasel/status/2103166902801740255
📌 BLUME est un framework de documentation open source qui transforme un simple dossier de fichiers Markdown en site de docs complet : navigation, recherche, thème, images Open Graph, sans une ligne de code d’application à maintenir. Sous le capot, il génère et pilote un projet Astro caché que vous pouvez éjecter pour reprendre la main. La version 2.0, publiée le 24 septembre 2026, en fait une plateforme d’adapters.
\n\n
Le créneau des frameworks de doc est bondé : Mintlify, Docusaurus, Starlight, Fumadocs ou Nextra occupent déjà le terrain. Ce qui distingue Blume, c’est le sens de sa promesse : « for humans and agents ». Le même contenu sert le lecteur et l’agent IA. Chaque page reste disponible en Markdown brut via une URL .md, le site publie un llms.txt et un llms-full.txt, expose une API JSON et peut héberger un serveur MCP pour que vos agents cherchent et lisent la doc directement. Accordéons, arbres de fichiers, groupes de code et infobulles deviennent du Markdown lisible dans tous ces formats.
Je trouve cette approche plus convaincante qu’un chatbot greffé en coin de page. Plutôt qu’une surcouche, la lisibilité machine est ici traitée comme un citoyen de première classe.
La 2.0 systématise le principe de l’adapter dans blume.config.ts :
- 📊 18 intégrations analytics (PostHog, Plausible, Google Analytics, Mixpanel, Amplitude, Clarity…), combinables dans une même liste
- 🔍 Recherche locale avec Orama par défaut, ou FlexSearch, Pagefind, Algolia, Typesense en un adapter
- 🤖 Ask AI branché sur OpenRouter, AI Gateway, Inkeep ou n’importe quel endpoint compatible OpenAI
- 🗂 Sources de contenu mixées dans un seul site : fichiers locaux, MDX distant, GitHub Releases, Notion, Sanity, Contentful, Payload, Strapi
- 🚀 Déploiement Vercel, Netlify, Cloudflare ou Node — sans rien configurer, Blume construit un site statique hébergeable partout
Les références API deviennent composables : OpenAPI, AsyncAPI, GraphQL et Scalar se mélangent dans une même liste, chacune sur sa propre route. Votre API publique, votre API interne et vos schémas d’événements peuvent cohabiter dans le même site. Chaque adapter déclare aussi ses dépendances et ses secrets, et blume doctor relit votre pile pour vérifier que rien ne manque.
Pour l’arrivée, deux commandes. npx blume migrate détecte un site Mintlify, Docusaurus, Starlight ou Nextra et confie la migration à Codex avec un plan de reprise. npx blume@latest upgrade fait de même pour passer de Blume 1 à Blume 2, modification par modification, puis lance les vérifications de build.
La nuance qui compte : le projet est jeune, porté essentiellement par Hayden Bleasel, et la 2.0 sort tout juste avec des centaines de correctifs. L’écosystème doit encore faire ses preuves, même si le dépôt affiche déjà environ 1 700 étoiles. Il faut aussi Node.js 22.12 minimum. En face : licence MIT, sortie propre vers un projet Astro standard, et une documentation qui applique ce qu’elle préche.
Pour qui maintient une doc produit, Blume 2.0 mérite au moins un essai sur un projet secondaire. Gratuit, open source, et cohérent avec sa promesse : une seule source de vérité, lisible par vous et par vos agents.
Sources
\n »
