blume
Installation
SKILL.md
Blume
Blume is an open-source, markdown-first documentation framework built on Astro and Vite. Drop Markdown or MDX into a folder, run blume dev, and get a production-grade docs site — navigation, search, theming, Open Graph images, and a rich component library — with no app boilerplate to write or maintain.
The core idea: the framework is the template. There's no starter to clone and no project to own before you've written a word. The only thing you touch is your content. When you outgrow the defaults, you add configuration one file at a time — and you can blume eject to a plain Astro project the day you want full control.
What makes it different
- Fast by default — Static HTML on Astro/Vite. The core theme ships no client framework JS so pages score well on Core Web Vitals out of the box. You opt into server features only when you need them.
- AI-ready out of the box — Emits
llms.txt/llms-full.txt, serves any page's raw Markdown by appending.mdto its URL, publishes a JSON docs API (/api/docs/…) described by an OpenAPI document at/openapi.json, offers Copy as Markdown and Open in chat on every page, and can host an optional in-page assistant or an MCP server so coding agents read your docs directly. - Zero configuration — even the template — A folder of docs is a complete project. Navigation is inferred from files, search works in dev and production with no hosted service, and theming is a handful of tokens.
- Type-safe to the core —
blume.config.tsand everymeta.tsare real TypeScript, validated by a schema and authored withdefineConfiganddefineMeta. Your editor autocompletes options and catches mistakes before a build.
Quickstart
Blume needs Node.js 22.19 or newer. From an empty folder: