What is blume?

Blume is a tool for turning a folder of Markdown or MDX files into a full documentation website with almost no setup. You point it at a folder of content, run one command to start a dev server, and it gives you navigation, search, page theming, social share images, and a library of ready made components, without writing any application code yourself. Behind the scenes, Blume generates and manages a hidden Astro project on your behalf, so you never have to configure Astro or a CSS framework directly. If you later want full control over that generated project, a single command called eject converts it into a standalone Astro app that still depends on the Blume package. The output of a normal build is static HTML, which can be hosted on almost any static hosting service, though switching to a server based deployment unlocks features that need to respond to requests live, such as an AI powered search assistant. Configuration files are written in real TypeScript and checked against a schema, so mistakes get caught by your editor before you even build the site. The component library covers common documentation needs like tabs, code groups, file trees, and step by step instructions, all usable directly inside MDX pages without manual imports. Search runs locally by default using a library called Orama, though it can be swapped for other search providers with a single setting. Blume also pays specific attention to being usable by AI systems and coding agents, offering raw Markdown versions of every page, a hosted server that lets agents search and read the docs, and bundled skills that teach a coding agent how to write and maintain a docs site built with Blume. Getting started requires Node.js 22.12 or newer and works with npm, pnpm, yarn, or Bun. The project itself is a monorepo containing both the published package and its own documentation site, which is built using Blume itself. It is released under the MIT license and is aimed at developers and teams who want a documentation site without maintaining a custom application for it.