curious what "AI-ready" means concretely here - is it generating something like an llms.txt under the hood, or is it more about the markdown being cleanly chunked/structured for retrieval. the docs tools I've seen that use this label usually just mean well-formed markdown, but the actual pain point for me has always been staleness - docs drifting from the real API surface over time. does blume do anything to flag that drift, or is it purely a generation/theming layer on top of whatever markdown you feed it
@galdayan Means lots of things - llms.txt, raw markdown via negotiation headers, mcp servers, agent readability, skills. All in the pursuit of making your docs easier to read by agents. Check it out here: https://useblume.dev/docs/configuration/ai
@galdayan As for staleness, we have a few things to help here e.g. translations but hoping we can work on bridging the gap between product and docs more going forward, perhaps with skills.
@haydenbleasel that's a fair scope for a docs framework specifically - the drift problem really lives one layer up, in the CI/build pipeline diffing docs against the actual API surface, not in how the markdown gets served. skills as the bridge makes sense, thanks for the link, going to read through the ai config page properly
Report
Huge congratulations on the release! The decision to ship AI-ready endpoints alongside static Astro performance is a massive win for modern docs.
Does Blume support custom MDX components out of the box, or do those require extending the config? Upvoted and wishing you a great launch day!
Markdown-first and zero-config is the right call for docs tools - Mintlify and Fumadocs both make you fight the config at some point. Curious how Blume handles versioned docs (multiple releases living side by side) - is that on the roadmap or are you staying intentionally minimal for now?
Markdown-first plus one-command deploys is a strong combination. How does Blume handle larger documentation sets with versioned APIs and shared content across multiple products?
Replies
Mastra
the maker of @Ultracite keeps cooking.
@haydenbleasel just introduced @Blume, an open-source alternative to @Mintlify and @Fumadocs that is fast, AI-ready, and zero-config.
view source code here
Dial
curious what "AI-ready" means concretely here - is it generating something like an llms.txt under the hood, or is it more about the markdown being cleanly chunked/structured for retrieval. the docs tools I've seen that use this label usually just mean well-formed markdown, but the actual pain point for me has always been staleness - docs drifting from the real API surface over time. does blume do anything to flag that drift, or is it purely a generation/theming layer on top of whatever markdown you feed it
Ultracite
@galdayan Means lots of things - llms.txt, raw markdown via negotiation headers, mcp servers, agent readability, skills. All in the pursuit of making your docs easier to read by agents. Check it out here: https://useblume.dev/docs/configuration/ai
Ultracite
@galdayan As for staleness, we have a few things to help here e.g. translations but hoping we can work on bridging the gap between product and docs more going forward, perhaps with skills.
Dial
@haydenbleasel that's a fair scope for a docs framework specifically - the drift problem really lives one layer up, in the CI/build pipeline diffing docs against the actual API surface, not in how the markdown gets served. skills as the bridge makes sense, thanks for the link, going to read through the ai config page properly
Huge congratulations on the release! The decision to ship AI-ready endpoints alongside static Astro performance is a massive win for modern docs.
Does Blume support custom MDX components out of the box, or do those require extending the config? Upvoted and wishing you a great launch day!
Ultracite
@vahid_davoudi Yep custom MDX is definitely supported: https://useblume.dev/docs/configuration/customization
Dial
Markdown-first and zero-config is the right call for docs tools - Mintlify and Fumadocs both make you fight the config at some point. Curious how Blume handles versioned docs (multiple releases living side by side) - is that on the roadmap or are you staying intentionally minimal for now?
Meridian
Markdown-first plus one-command deploys is a strong combination. How does Blume handle larger documentation sets with versioned APIs and shared content across multiple products?
Aymo AI
Amazing stuff!
We generally use Fuma or Nextra, but it seems like found a better alternative. Congrats on the launch, and thanks for building this.
Congratulations on the launch! The service can integrate with Claude Code, right?