Quickstart
Install Blume, scaffold a project, and ship your first page in minutes.
Go from an empty folder to a running docs site in a few commands. Blume needs Node.js 22 or newer and a docs/ folder with at least one .md or .mdx file — there’s nothing else to set up.
Install and run
Install Blume
Add the package to a new or existing project.
npm install blumepnpm add blumeyarn add blumebun add blumeScaffold a project
blume init creates the minimum surface: a content folder and a config file.
blume initdocs/
index.mdx
blume.config.tsStart the dev server
Blume generates the runtime and serves your docs with hot reload.
blume devBuild for production
Static HTML is written to dist/, with a local search index built over it.
blume buildWrite your first page
Every page is Markdown or MDX with a little frontmatter — the title and description render as the page heading and intro automatically. Drop this into docs/index.mdx:
---
title: Introduction
description: Welcome to my docs.
---
Welcome! Use **Markdown** and built-in components — no imports required:
:::note
Blume ships callouts, cards, tabs, steps, and more.
:::Save it, and the dev server reloads instantly. Navigation, search, and page metadata are inferred from your files as you add them — keep writing, and the site keeps up.