# haydenbleasel/blume

World-class docs for everything you ship. Fast, AI-ready, and zero-config.

Repository: https://github.com/haydenbleasel/blume
Canonical: https://ross.abutalabs.com/products/blume
Homepage: https://useblume.dev/
Language: TypeScript
License: MIT
License Family: permissive
Topics: docs, mdx, typescript
Last push: 2026-08-22T19:21:01+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 5
- inputs: {"age_days": 73, "days_push": 11, "days_rel": 13, "gap_med": 0, "n_releases_24m": 22}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1352, forks 81 (observed 2026-08-28T04:04:28.192407+00:00)

## What it is
Blume is an open-source, zero-config documentation framework built on Astro and Vite that turns a folder of Markdown/MDX files into a production-grade docs site with navigation, search, theming, and SEO out of the box. It is AI-ready with llms.txt generation, raw Markdown endpoints, an Ask AI assistant, and a hosted MCP server, and can be ejected to a standalone Astro app for full control.

## Use cases
- build a documentation site from markdown files
- create zero-config docs for an open-source project
- generate llms.txt and AI-ready documentation
- self-host a fast static docs site with local search
- mix local markdown with Notion, Sanity, or GitHub content into one docs site
- add an in-page AI assistant grounded in my docs
- deploy documentation to Vercel, Netlify, or GitHub Pages

## When to choose
- you want a polished docs site without scaffolding or maintaining an app boilerplate
- you need AI-consumable documentation (llms.txt, raw markdown, MCP) out of the box
- you want fast static HTML with strong Core Web Vitals and no client framework JS
- you prefer self-hosting with no vendor lock-in instead of a managed platform like Mintlify

## When to avoid
- you need a fully custom Next.js/React docs app with bespoke layouts from day one
- you require a managed hosted documentation service with collaboration features
- your project is not on Node.js 22.12 or newer
- you need deep customization beyond what ejecting to Astro provides

## Facets
- artifact type: framework
- maturity: active
- function: static-site-generator, documentation, search-engine, markdown, cli, mcp, ssr
- domain: documentation, web-development, developer-tools, frontend
- platform: cli, cross-platform
- tags: docs-framework, mdx, astro, vite, llms-txt, zero-config, local-search, open-graph-images, ai-ready-docs, nodejs, web-server

## Member repositories
- haydenbleasel/blume (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:28.192407+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:42:09.218087+00:00, confidence not recorded.
  - readme: https://github.com/haydenbleasel/blume (fetched 2026-08-28T04:04:28.192407+00:00, sha 63a9cd721c37)
  - homepage: https://useblume.dev/ (fetched 2026-08-29T12:01:09.024140+00:00, sha 0af0c6a2dade)
  - site_page: https://useblume.dev/docs (fetched 2026-08-29T12:01:09.034886+00:00, sha ed2dc28c1730)
  - site_page: https://useblume.dev/docs/content/sources (fetched 2026-08-29T12:01:09.047196+00:00, sha 33435b448d11)
  - site_page: https://useblume.dev/docs/content/components (fetched 2026-08-29T12:01:09.049264+00:00, sha c667d5515a7a)
  - site_page: https://useblume.dev/docs/quickstart (fetched 2026-08-29T12:01:09.051568+00:00, sha 79a35a3e5849)
  - site_page: https://useblume.dev/docs/deployment (fetched 2026-08-29T12:01:09.053366+00:00, sha e89cd519cc77)
  - site_page: https://useblume.dev/docs/faq (fetched 2026-08-29T12:01:09.055249+00:00, sha 2ac97e3b9243)
  - registry_npm: https://registry.npmjs.org/blume (fetched 2026-08-29T12:01:09.057186+00:00, sha 13028ee7de22)
  - site_page: https://useblume.dev/changelog/blume-1-5-3 (fetched 2026-08-29T12:01:09.037728+00:00, sha c45b04714662)
- Data as of 2026-08-30T08:39:29.467469+00:00.