Developer Tools
Blume: Open-Source Docs Framework Converts Markdown Folders Into AI-Ready Websites
A new zero-config documentation tool from Hayden Bleasel turns plaintext Markdown into searchable, AI-compatible documentation sites with no setup overhead.
InfoQ
Blume, an open-source documentation framework that transforms a directory of Markdown files into a fully functional documentation website, has gained traction since its recent release. Developed by Hayden Bleasel and built atop Astro and Vite, the project has amassed over 1,300 GitHub stars and currently ranks among the platform's top trending TypeScript repositories.
How It Works#
The framework's core appeal lies in its minimal footprint and configuration-free approach. Rather than requiring developers to scaffold boilerplate or maintain a separate app, Blume reads a blume.config.ts file, constructs an internal content graph, and generates a hidden Astro project that powers both development and production builds. Getting started requires only Node.js 22.12+ and a single Markdown file:
npx blume init
blume dev
blume build
Configuration is entirely optional and type-safe, validated through a schema-backed defineConfig function. The framework ships as MIT-licensed software on GitHub and is available via npm.
AI-Ready Documentation#
A defining feature is its built-in support for machine-readable content. Blume automatically generates llms.txt and llms-full.txt files, serves unformatted Markdown at .md URLs, and can expose a hosted Model Context Protocol (MCP) server. The framework also includes a blume eval command that transforms documentation into an automated test suite—agents answer questions using only the docs, judges score the responses, and CI pipelines fail if the docs prove insufficient.
Design and Architecture#
The framework positions itself as a middle ground between rival approaches. It contrasts with Mintlify (a hosted, proprietary platform) and tools like Fumadocs, Nextra, and Docusaurus (which require scaffolding a React-based app). Blume offers open-source hosting flexibility while keeping the core theme dependency-free—no client-side JavaScript from the framework itself. Developers can still customize via component overrides or use blume eject to promote the generated runtime into a standalone Astro project.
