Blume: Zero-Config Docs Framework That Turns a Markdown Folder into an AI-Ready Website
Blume is an open-source documentation framework that converts Markdown into a complete documentation site. Built with Astro and Vite, it requires only Node.js and a single Markdown file for setup. The framework supports various configurations, offers automatic SEO features, and includes tools for document testing. It facilitates migration from other documentation systems. By Daniel Curtis
Blume is an open-source documentation framework that allows users to turn a folder of Markdown files into a complete AI-ready website with zero configuration. Developed by Hayden Bleasel, it is built on Astro and Vite and released under the MIT license on GitHub. The framework received significant attention, reaching number seven on GitHub's TypeScript trending list and garnering over 1,300 stars.
Blume simplifies the documentation process by eliminating the need for boilerplate code. Users only need Node.js 22.12 or newer and a single Markdown file to get started. The CLI scans the content into a graph, generating a hidden Astro project under .blume/ for development and building. Configuration is optional and type-safe, validated through defineConfig schema.
Upon generation, sites emit llms.txt and llms-full.txt, serving raw Markdown at any .md URL and providing the ability to expose a hosted MCP server. Blume also offers an eval tool that converts documentation into a test suite, enabling agents to answer user questions using only the provided documentation. CI fails when the documentation cannot answer the questions.
The framework received feedback from users, including a request for route-based page tabs for design system documentation. In response, Blume shipped query-parameter tabs, offering shareable tab URLs and multiple groups per page. However, it doesn't provide separate indexed URLs for each tab.
Other issues reported by users include dark mode elements flickering during client-side navigation and incorrect font fallback for Vietnamese text. Blume has addressed these concerns with a workaround for the oxfmt formatting issue and pinned patches for upstream bugs.
Blume's migration skills facilitate the translation of source config into blume.config.ts, restructuring content into filesystem-derived navigation with redirects, rewriting callouts to ::: directives, converting icons to Lucide, and pointing generated API references at openapi.sources. A third-party account showcases the migration process from Fumadocs to Blume.
Compared to rivals like Mintlify, Fumadocs, Nextra, and Docusaurus, Blume stands out as an open-source, hostable solution with only Markdown as the required asset. It provides a core theme with no client framework JavaScript, allowing users to escape to component overrides or blume eject, promoting the generated runtime into a standalone Astro app. Blume gained significant traction on Product Hunt, ranking second of the day with 304 upvotes shortly after its launch and receiving coverage from MarkTechPost in July.
Written by urgent.news from InfoQ's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.
