Hayden Bleasel, an expert developer from OpenAI, released Blume, an open-source documentation framework. Blume shipped to npm as version 1.0.3 the same day. It is as simple as Drop Markdown into a folder and ship a docs site. No app boilerplate is written or maintained afterward. The project is MIT-licensed and open sourced.
What is Blume?
Blume is a command-line tool paired with a component library for docs. It reads a folder of Markdown or MDX files. From that folder, it produces a production-grade documentation site. That output ships navigation, search, theming, and Open Graph images. Configuration stays optional and is added one file at a time. The code is a TypeScript monorepo; the published package sits at packages/blume. Blume’s own documentation, under apps/docs, is built with Blume itself. It requires Node.js 22.12 or newer. It runs with Bun, pnpm, npm, or yarn.
How Blume Works?
Under the surface, Blume generates and drives a hidden Astro project. First, the CLI loads blume.config.ts and scans your content into a graph. Next, it writes an Astro project into a .blume/ directory. Astro then renders every page through a single catch-all route. That route imports Blume’s shipped components, the generated data, and your overrides. On each run, .blume/ regenerates, and only changed files are rewritten. As a result, hot reload stays fast during editing. The core theme ships no client framework JavaScript. Consequently, pages score well on Core Web Vitals by default. When you need full control, blume eject promotes the runtime into a standalone Astro app. That ejected project still depends on the blume package.
Getting Started
Setup takes a single command: npx blume init. Afterward, blume dev starts a hot-reloading server. Meanwhile, blume build writes static HTML and a local search index into dist/. The config file is real TypeScript, validated by a schema.
CLI commands include: init, dev, build, add, sync, eject, validate, and doctor.
AI-Ready by Design
Beyond human readers, Blume targets agents too. Every page returns raw Markdown when you append .md to its URL. A single flag emits llms.txt and llms-full.txt for agents. Each page can be copied as Markdown or opened in ChatGPT, Claude, or v0. An optional in-page Ask AI assistant answers reader questions directly. It runs 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. Through it, Claude Code, Cursor, and VS Code read docs directly.
That server exposes four read-only tools: search_docs, get_page, list_pages, and get_navigation.
Use Cases
For an API product, drop in an OpenAPI or AsyncAPI spec; Blume renders an interactive reference via Scalar. For a library, point Blume at GitHub Releases for changelog timelines with RSS. Supports 36 locales and RTL. Can combine local files with Notion or Sanity.
Hayden Bleasel announced Blume on X on July 13, 2026. Early adopters include Quiver (moving from Mintlify) and Neon’s add-mcp docs.
Comparison Snapshot
Blume is MIT-licensed open-source CLI+framework vs Mintlify (hosted commercial), Docusaurus (React SSG), and Astro Starlight. Differentiator: built-in llms.txt/llms-full.txt, MCP server, and eject path to standalone Astro.