Hayden Bleasel, sviluppatore in OpenAI, ha rilasciato Blume, un framework open source per la documentazione, arrivato su npm come versione 1.0.3 lo stesso giorno del lancio. L’idea è diretta: metti dei file Markdown in una cartella e ottieni un sito di documentazione, senza scrivere né mantenere boilerplate applicativo. Il progetto è rilasciato con licenza MIT.
Cosa fa e come funziona
Blume è uno strumento a riga di comando abbinato a una libreria di componenti. Legge una cartella di file Markdown o MDX e produce un sito di documentazione con navigazione, ricerca, theming e immagini Open Graph. La configurazione resta opzionale e si aggiunge un file alla volta. Sotto la superficie genera e pilota un progetto Astro nascosto: la CLI carica blume.config.ts, scandisce i contenuti in un grafo e scrive un progetto Astro in una directory .blume/, rigenerata a ogni run ma riscrivendo solo i file cambiati. Il tema di base non spedisce JavaScript di framework lato client, quindi le pagine ottengono buoni punteggi sui Core Web Vitals per default. Con blume eject si promuove il runtime in un’app Astro autonoma, riducendo il lock-in a lungo termine. Richiede Node.js 22.12 o superiore e gira con Bun, pnpm, npm o yarn.
Pensato anche per gli agenti
La parte più interessante per chi lavora con LLM e agenti è il taglio “AI-ready”. Ogni pagina restituisce Markdown grezzo aggiungendo .md all’URL, e un singolo flag genera i file llms.txt e llms-full.txt. Ogni pagina può essere copiata come Markdown o aperta in ChatGPT, Claude o v0, e c’è un assistente opzionale “Ask AI” integrato nella pagina. Blume può anche ospitare un server Model Context Protocol (MCP) che espone quattro strumenti in sola lettura: search_docs, get_page, list_pages e get_navigation. Attraverso di esso strumenti come Claude Code, Cursor e VS Code leggono la documentazione direttamente.
La CLI copre l’intero ciclo di vita con comandi come init, dev, build, add, sync, eject, validate e doctor. Tra i limiti dichiarati: la versione 1.0.3 è nuova e l’ecosistema è ancora giovane, alcune funzioni request-time come Ask AI e MCP richiedono un server adapter, e ci sono meno integrazioni di terze parti rispetto alle piattaforme hosted mature. Tra i primi adottanti vengono citati Quiver, in migrazione da Mintlify, e la documentazione add-mcp di Neon.
- Blume converte una cartella di Markdown in un sito di documentazione con configurazione zero.
- Le funzioni AI sono integrate:
llms.txt, Markdown per pagina e un server MCP con quattro tool in lettura. - È MIT-licensed, richiede Node.js 22.12+ e può fare eject verso un’app Astro autonoma.
Fonte: Meet Blume: An Open-Source, Zero-Config Documentation Framework That Ships AI-Ready Docs From a Markdown Folder — https://www.marktechpost.com/2026/07/14/meet-blume-an-open-source-zero-config-documentation-framework-that-ships-ai-ready-docs-from-a-markdown-folder/
Hai qualcosa da aggiungere? Unisciti alla discussione.