Hayden Bleasel, a developer from OpenAI, has released Blume, an open-source documentation framework now available on npm as version 1.0.3. The framework is designed to operate with extreme simplicity: drop Markdown into a folder and ship a fully functional documentation site. Users write and maintain no app boilerplate after the initial setup, and the entire project carries the MIT license.<\/p>\n
Blume is a command-line tool paired with a component library for documentation. It reads a folder of Markdown or MDX files and produces a production-grade documentation site complete with navigation, search, theming, and Open Graph images. Configuration is entirely optional and can be added one file at a time. The codebase is a TypeScript monorepo, with the published package located at Under the surface, Blume generates and drives a hidden Astro project. The process begins when the CLI loads Setup takes a single command, making the onboarding process brief. After initialization, prepreprepre<\/p>\n Because the config is typed, editors catch mistakes before a build runs. The CLI covers the full lifecycle with commands beyond these basics:<\/p>\n Blume is built to serve both human readers and AI agents<\/a>. Every page returns raw Markdown when you append These capabilities translate to specific, practical jobs. For an API product, users can drop in an OpenAPI or AsyncAPI spec. Blume renders an interactive reference with schemas, authentication details, and a request playground via Scalar. For a library, Blume can point to GitHub<\/a> Releases. Each release rolls up into a generated changelog timeline with an RSS feed. For a global audience, users can add translated files per locale, with support for 36 locales, locale-aware routing, and right-to-left layouts. For mixed content, local files can be combined with remote MDX, Notion, or Sanity sources, with all sources rendering through the same components.<\/p>\n For context, here is how Blume compares to three common documentation approaches. Features change rapidly, so verifying current details before adoption is recommended.<\/p>\n Blume turns a Markdown folder into a production docs site with zero configuration. It drives a hidden Astro and Vite project and can eject to a standalone Astro app. Its AI features ship built in: Hayden Bleasel, a developer from OpenAI, has released Blume, an open-source documentation framework now available on npm as version 1.0.3. The framework is designed to operate with extreme simplicity: drop Markdown into a folder and ship a fully functional documentation site. Users write and maintain no app boilerplate after the initial setup, and the entire […]<\/p>\n","protected":false},"author":7,"featured_media":83950,"comment_status":"closed","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"fifu_image_url":"https:\/\/cards.overcentral.com\/cards\/en\/63301.png","fifu_image_alt":"OpenAI Developer Ships Blume, an Open-Source Docs Framework","footnotes":""},"categories":[349],"tags":[],"class_list":["post-63301","post","type-post","status-publish","format-standard","has-post-thumbnail","category-articles"],"fifu_image_url":"https:\/\/cards.overcentral.com\/cards\/en\/63301.png","fifu_image_alt":"OpenAI Developer Ships Blume, an Open-Source Docs Framework","_links":{"self":[{"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/posts\/63301","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/comments?post=63301"}],"version-history":[{"count":0,"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/posts\/63301\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/media\/83950"}],"wp:attachment":[{"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/media?parent=63301"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/categories?post=63301"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/overcentral.com\/en\/wp-json\/wp\/v2\/tags?post=63301"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}packages\/blume<\/code>codecodecodecode. Blume’s own documentation, found in apps\/docs<\/code>codecodecodecode, is built with Blume itself. The framework requires Node.js 22.12 or newer and works with Bun, pnpm, npm, or yarn.<\/p>\nHow Blume Works<\/h2>\n
blume.config.ts<\/code>codecodecodecode and scans your content into a graph. It then writes an Astro project into a .blume\/<\/code>codecodecodecode directory. Astro renders every page through a single catch-all route that imports Blume’s shipped components, the generated data, and any user overrides. On each run, the .blume\/<\/code>codecodecodecode directory regenerates, rewriting only changed files, which keeps hot reloading fast during editing. The core theme ships with no client framework JavaScript, so pages achieve strong Core Web Vitals scores by default. For users needing full control, the blume eject<\/code>codecodecodecode command promotes the runtime into a standalone Astro app, though the ejected project still depends on the blume<\/code>codecodecodecode package.<\/p>\nGetting Started with Blume<\/h2>\n
blume dev<\/code>codecodecodecode starts a hot-reloading server, and blume build<\/code>codecodecodecode writes static HTML and a local search index into dist\/<\/code>codecodecodecode. The configuration file is written in TypeScript and validated by a schema.<\/p>\n[code block]<\/pre>\n
\n
blume init<\/code>codecodecodecode: Scaffold a project, interactive by default<\/li>\nblume dev<\/code>codecodecodecode: Start the dev server with hot reload<\/li>\nblume build<\/code>codecodecodecode: Build the static or server site<\/li>\nblume add<\/code>codecodecodecode: Install a source component from the registry<\/li>\nblume sync<\/code>codecodecodecode: Re-fetch remote content sources<\/li>\nblume eject<\/code>codecodecodecode: Promote the runtime into a standalone Astro app<\/li>\nblume validate<\/code>codecodecodecode: Check internal, anchor, asset, and external links<\/li>\nblume doctor<\/code>codecodecodecode: Diagnose configuration and content problems<\/li>\n<\/ul>\nAI-Ready by Design<\/h2>\n
.md<\/code>codecodecodecode to its URL. A single flag emits llms.txt<\/code>codecodecodecode and llms-full.txt<\/code>codecodecodecode files for AI agents. Each page can be copied as Markdown or opened directly in ChatGPT, Claude, or v0. An optional in-page Ask AI assistant<\/a> answers reader questions directly, running on the AI SDK through the Vercel AI Gateway, OpenRouter, Inkeep, or any OpenAI-compatible endpoint. Blume can also host a Model Context Protocol (MCP) server, allowing Claude Code<\/a>, Cursor, and VS Code to read documentation directly. That server exposes four read-only tools: search_docs<\/code>codecodecodecode, get_page<\/code>codecodecodecode, list_pages<\/code>codecodecodecode, and get_navigation<\/code>codecodecodecode.<\/p>\nUse Cases With Examples<\/h2>\n
How Blume Compares<\/h2>\n
\n\n
\n \nDimension<\/th>\n Blume<\/th>\n Mintlify<\/th>\n Docusaurus<\/th>\n Astro Starlight<\/th>\n<\/tr>\n<\/thead>\n \n Type<\/td>\n Open-source CLI + framework<\/td>\n Hosted commercial platform<\/td>\n Open-source SSG<\/td>\n Open-source Astro theme<\/td>\n<\/tr>\n \n License<\/td>\n MIT, free<\/td>\n Proprietary; paid Pro tier<\/td>\n MIT, free<\/td>\n MIT, free<\/td>\n<\/tr>\n \n Setup<\/td>\n Zero-config Markdown folder<\/td>\n Config-driven, managed<\/td>\n Scaffold + React config<\/td>\n Astro project + theme<\/td>\n<\/tr>\n \n Engine<\/td>\n Hidden Astro + Vite<\/td>\n Proprietary hosted<\/td>\n React<\/td>\n Astro<\/td>\n<\/tr>\n \n Core-theme client JS<\/td>\n None (static HTML)<\/td>\n \u2014<\/td>\n React runtime<\/td>\n Minimal (islands)<\/td>\n<\/tr>\n \n llms.txt<\/code>codecodecodecode \/ llms-full.txt<\/code>codecodecodecode<\/td>\nBuilt-in flag<\/td>\n Auto-generated<\/td>\n Community plugin<\/td>\n Community plugin<\/td>\n<\/tr>\n \n Built-in MCP server<\/td>\n Yes (four read-only tools)<\/td>\n Yes (auto-hosted)<\/td>\n Not built-in<\/td>\n Not built-in<\/td>\n<\/tr>\n \n Eject path<\/td>\n Standalone Astro app<\/td>\n Not applicable (hosted)<\/td>\n \u2014<\/td>\n Already Astro<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Strengths and Weaknesses<\/h2>\n
Strengths<\/h4>\n
\n
llms.txt<\/code>codecodecodecode, per-page Markdown, MCP server, and Ask AI.<\/li>\nWeaknesses<\/h4>\n
\n
Who Should Try Blume Now<\/h2>\n
llms.txt<\/code>codecodecodecode, per-page Markdown, and an MCP server. The framework is MIT-licensed, requires Node.js 22.12+, and reached npm version 1.0.3 on its launch day. Early adopters include Quiver, which is moving from Mintlify, and the Neon project for its add-mcp documentation. For any developer or team that wants to ship documentation without maintaining a framework or spending on a hosted platform, Blume is available immediately on GitHub and npm. The single-command start and static-first architecture make it a low-risk project to test for a new library, API, or open-source tool.<\/p>\n","protected":false},"excerpt":{"rendered":"