Fumadocs (Foo-ma docs) is a React documentation framework that turns MDX content into fast docs sites with built-in search, theming, and OpenAPI support. It layers a headless core, a default theme, content-source adapters, and a component CLI, and plugs into the React framework the team already uses. It serves React developers and product teams that want code-level control over their documentation, blog, or API reference instead of a config-file generator or a hosted docs service.[1][2]
Quick verdict
React teams building product documentation with full code control will benefit most from Fumadocs. Its breakable-framework design turns MDX into fast docs with built-in search, OpenAPI pages, and LLM-ready output while every component stays forkable code. The material constraint is staffing: customization needs React developers and every site deploys on infrastructure the team provisions, so teams wanting config-file simplicity or a hosted service should choose something else. If you have React developers and want to own your docs stack, choose Fumadocs; if you need zero-code setup or vendor hosting, choose Docusaurus or Mintlify.[1][2][3]
Key features
MDX content source Fumadocs MDX is the default content source, with adapters for external CMS products and realtime content updates, so authors write Markdown or MDX while the framework builds the page tree and navigation.[1]
Multi-provider search Document search ships built in with a choice of providers including Orama and Algolia, alongside fetch-based options, so teams pick the index that fits their scale rather than wiring search themselves.[1][2]
OpenAPI reference generation API definitions generate interactive OpenAPI reference pages inside the same docs site, keeping endpoint documentation next to guides instead of on a separate portal.[1]
TypeScript Twoslash samples Code samples support TypeScript Twoslash annotations, so docs pages show type-checked, hoverable snippets that stay honest about the APIs they demonstrate.[1]
Five-framework support One scaffolding command starts projects on Next.js, Astro, Waku, React Router, or TanStack Start with Node 22 or newer, so teams keep their existing React stack.[1]
Static output with RSC and i18n Sites render through React Server Components with static generation and internationalization support, producing fast pages that can be served as fully static files.[1][2]
Component CLI The command-line tool installs and forks theme components Shadcn-style, so customization means owning real component code rather than overriding theme settings.[1][2]
LLM-ready output New apps configure llms.txt generation and MCP support by default, so AI assistants and agents can read the published documentation as structured context.[1]
Who will love it
React teams building product documentation with full code control will love it, because the breakable-framework philosophy trades abstraction for direct ownership of every docs component.[1][2]
Developers customizing docs beyond what config-file frameworks allow will love it, because the composable UI and CLI forking path exist precisely for layouts that settings cannot express.[1][2]
Projects adding a blog, FAQ, or showcase beside their docs will love it, because documentation plus blog use cases are documented first-class patterns rather than bolt-on themes.[1][2]
Who should avoid it
Teams without React developers should avoid it, because the official comparison states builders may need more React knowledge than with opinionated alternatives such as Docusaurus.[1]
Teams wanting a provider-hosted docs service should avoid it, because every deployment path runs on infrastructure the adopter provisions: framework hosting, Docker, or static files.[1]
Teams expecting a vendor-supported edition with SLAs should avoid it, because the MIT-licensed framework has no paid tier and maintenance funding runs through voluntary sponsorship.[1][2]
Compatibility and alternatives
Against Docusaurus, the tradeoff is flexibility versus ecosystem: Docusaurus offers a plugin ecosystem and config-driven setup, while Fumadocs offers code-level control at the cost of more React knowledge.[1]
Against Mintlify, the tradeoff is control versus hosting: Mintlify is a paid hosted service, while Fumadocs is free open source the team deploys itself, and the official page advises teams already settled on Mintlify not to switch.[1]
Questions worth asking
What is the best Fumadocs alternative for non-technical users?
Docusaurus is the safer conditional choice for non-technical teams because its config-driven setup and plugin ecosystem need less React code, while Fumadocs suits teams that want code-level control over every docs component.[1]
Is Fumadocs really no-code?
How much does Fumadocs cost per month?
Can you self-host Fumadocs?
Yes. Adopters build and host the docs site on their own infrastructure through the underlying React framework's hosting, a documented Docker example, or a fully static CDN-hostable build. There is no provider-hosted cloud tier.[1]
Sources and editorial review
Source research. Reviewed on October 9, 2026. Written by Sanjib Sah. AI assisted; reviewed by a human editor.
We have not run or tested this product.
- Fumadocs homepage
official · Observed October 5, 2026
Official homepage presenting Fumadocs as a React.js docs framework with one-command scaffolding and framework/CMS composition; primary evidence for identity and positioning.
- Fumadocs quick start
official · Observed October 9, 2026
Official quick start defining the Core, UI, content-source, and CLI layers, scaffolding commands, supported frameworks, and default LLM/metadata integrations; read in full on October 9, 2026.
- What is Fumadocs
official · Observed October 5, 2026
Official what-is page stating the breakable-framework philosophy, code-level control, RSC output, composable UI, and docs-plus-blog use cases.
- Fumadocs comparisons
official · Observed October 5, 2026
Official comparisons against Nextra, Mintlify, and Docusaurus, including the React-knowledge tradeoff and the paid-service versus free-open-source distinction.
- Fumadocs deploying guide
official · Observed October 5, 2026
Official deploying guide covering underlying-framework hosting, the Docker example for Fumadocs MDX apps, and fully static CDN-hostable builds.
- fuma-nama/fumadocs repository
official · Observed October 5, 2026
Canonical repository page confirming owner fuma-nama, project name, and MIT licensing with sponsors funding link; version currency cross-checked against the npm registry (fumadocs-core 16.17.1) on October 9, 2026.
- fumadocs-core package manifest
official · Observed October 5, 2026
Package manifest for fumadocs-core in the 16.17.x line declaring MIT license, React.js library purpose, and framework-adapter, search-client, and MCP module exports.
Compared with these products
No explicit proprietary baseline is recorded.