sitdraw

Blume Explained: 2026 Zero-Config Docs Framework and AI-Ready Sites

InfoQ (5 Sep) covered Blume: drop Markdown, get a docs site. Hidden Astro under .blume/, MIT, 1,300+ stars. AI-ready means llms.txt, MCP, and eval.

InfoQ wrote up Blume on 5 September 2026. Hayden Bleasel’s open-source docs framework turns a Markdown folder into a full site on Astro and Vite, MIT-licensed.

Decide a move by matching these names: Blume, zero-config docs, and the command blume eval.

Sep 5InfoQ write-up
1,300+GitHub stars then
22.12Minimum Node.js

The framework is the template

Nothing to clone

The CLI reads blume.config.ts, scans content into a graph, and writes a hidden Astro project under .blume/. Quickstart: Node.js 22.12 and one Markdown file.

Config is optional

defineConfig type-checks the file. Commands are npx blume init, then blume dev and blume build. The core theme ships no client-framework JavaScript.

AI-ready means lots of things — llms.txt, raw markdown via negotiation headers, MCP servers, agent readability, skills. — Hayden Bleasel, via InfoQ / Product Hunt

Where the numbers come from

Look atBaselineBlume
License and stackHosted closed core / React scaffoldMIT, Astro + Vite
AI-readableChunk later for retrievalllms.txt, raw .md, hosted MCP
MigrationHand-edit navigationblume-migrate: Mintlify, Docusaurus, Fumadocs, Nextra, Starlight
Coverage heat—1,300+ stars; TS trending #7; PH #2 that day, 304 votes

Should you migrate now

  1. 01
    Match the work

    Docs already in Markdown, a team tired of a React app, and agents that should read the site are the audience. Do not treat a trending list as the decision.

  2. 02
    Read the behavior diffs

    oxfmt can collapse :::note onto one line; the FAQ calls this an upstream Prettier Markdown printer bug, with a pinned patch as workaround. Dark-mode flicker and Vietnamese font fallback also showed up in issues.

  3. 03
    Do not treat a docs site as a design review

    Faster docs still leave module boundaries on one drawing. Open sitdraw when the meeting is the diagram.

Did Blume ship in September?
No. MarkTechPost covered a July launch. InfoQ on 5 September is follow-up coverage, not the first release date.
Is this the same story as pnpm 12?
No. That is a package-manager engine change. This is a docs-site generator.

Start with whether an agent can read your docs

llms.txt, raw .md, MCP, and whether blume eval fails CI. The full list stays in the official docs.

# Blume quickstart (InfoQ / official)
npx blume init
blume dev

Start the picture