# Fumadocs — card for AI agents

Next.js / React Router docs framework with ready templates (docs layout, search, OpenAPI pages).

Category: Page and site templates · maker Fuma · checked 2026-11-05 · style: minimal

## Price
- Price: Free
- Free tier: Fully free.

## License
MIT — https://raw.githubusercontent.com/fuma-nama/fumadocs/main/LICENSE

- commercial: **yes** (Commercial use OK)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://raw.githubusercontent.com/fuma-nama/fumadocs/main/LICENSE)
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
  (https://raw.githubusercontent.com/fuma-nama/fumadocs/main/LICENSE)
- in app: **yes** (Can ship inside your app)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://raw.githubusercontent.com/fuma-nama/fumadocs/main/LICENSE)
- redistribute: **yes** (Can pass the files on to your own users)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://raw.githubusercontent.com/fuma-nama/fumadocs/main/LICENSE)

## Rules to follow
- Keep the MIT copyright notice in the code if you redistribute it.
- No visible credit on the site is required by the licence.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How an agent gets files
- npm create fumadocs-app; no account. (sign-in: none)
- Formats: mdx, tsx
- Not allowed: Needs Node.js

## How to connect
- Package (npm/PyPI)
- npm: `npm install create-fumadocs-app`
- Repository: https://github.com/fuma-nama/fumadocs
- Website: https://fumadocs.dev

## Numbers (AgentGid data)
- Gid Score: 27
- GitHub stars: 13,648
- Downloads last week: 2,867

## Lines to paste into your prompt or AGENTS.md

```
- Fumadocs (Page and site templates). Next.js / React Router docs framework with ready templates (docs layout, search, OpenAPI pages). Price: free; commercial use OK; no credit needed. Style: minimal.
  Connect: npm create-fumadocs-app.
  Get files: npm create fumadocs-app; no account (mdx, tsx).
  Not allowed: Needs Node.js
  Rule: Keep the MIT copyright notice in the code if you redistribute it.
  Rule: No visible credit on the site is required by the licence.
  License: https://raw.githubusercontent.com/fuma-nama/fumadocs/main/LICENSE (checked 2026-11-05; details: https://agentgid.com/assets/fumadocs/)
```

## Links
- AgentGid page: https://agentgid.com/assets/fumadocs/
- Is it free for commercial use? https://agentgid.com/assets/fumadocs/commercial-use/
- Source: https://fumadocs.dev
- Source: https://github.com/fuma-nama/fumadocs
- Source: https://raw.githubusercontent.com/fuma-nama/fumadocs/main/LICENSE


## Fumadocs: a docs website inside your React app

Fumadocs is a free kit for building a documentation website inside a React app, such as one made with Next.js or Astro. You write pages as Markdown files and get a ready docs layout with a sidebar, search and light and dark themes. It can also turn an OpenAPI file into API reference pages and serve your docs as plain text for AI assistants.

### Where to use it
- Help pages for your product: Start a docs site for your app or library and write each page as a Markdown file. The sidebar, search and theme come ready.
- Reference pages for your API: If your backend has an OpenAPI file, Fumadocs makes one reference page per request type from it, so the pages stay in step with the code.
- Docs that AI assistants can read: Publish your docs as plain Markdown at /llms.txt and /llms-full.txt, so AI coding assistants can read the whole manual in one go.
- Docs on plain static hosting: Build the whole docs site as ready HTML files and put it on any static host, with search running in the reader's browser.
- A blog next to the docs: Add a blog with posts, tags and authors to the same site, written as Markdown files like the docs.
- Docs in several languages: Offer the same docs in more than one language, with the sidebar and pages switching by language.

### How to start
- With Node.js 22 or newer, create a new docs app and pick the framework and content source when asked.

```
npm create fumadocs-app
```

- Write your first page as an MDX file in the docs folder.

```
---
title: Hello World
---

## Yo what's up
```

- Run the app and open the docs page in the browser.

```
npm run dev
```


### License
MIT license: free to use in personal and paid products, and you may change and share the code. Keep the copyright and license notice with copies of the code; no visible credit on the site is required.

### Good to know
- It needs Node.js 22 or newer. On older versions the build can fail with errors about missing files.
- You need some React knowledge to change how pages look. The makers say a simple docs site may be easier with Docusaurus.
- By default the site needs a running server. For plain file hosting you turn on static export and set search up for it.
- All its packages use the modern import style only, so old require() code cannot load them.
- There are fewer ready plugins than for Docusaurus, so some features you build yourself.

Checked 2026-11-12 against: https://fumadocs.dev, https://fumadocs.dev/docs, https://fumadocs.dev/docs.mdx, https://fumadocs.dev/llms.txt, https://fumadocs.dev/docs/next.mdx, https://fumadocs.dev/docs/next/what-is-fumadocs.mdx, https://fumadocs.dev/docs/next/comparisons.mdx, https://fumadocs.dev/docs/next/deploying/static.mdx, https://fumadocs.dev/docs/next/search.mdx, https://fumadocs.dev/docs/next/integrations/openapi.mdx, https://fumadocs.dev/docs/next/integrations/llms.mdx, https://fumadocs.dev/docs/next/integrations/blog.mdx, https://fumadocs.dev/docs/next/internationalization.mdx, https://github.com/fuma-nama/fumadocs, https://github.com/fuma-nama/fumadocs/blob/HEAD/README.md, https://raw.githubusercontent.com/fuma-nama/fumadocs/main/LICENSE, https://registry.npmjs.org/create-fumadocs-app/latest, https://registry.npmjs.org/fumadocs-ui/latest

### Mistakes to avoid
- Don't: Running create-fumadocs-app or a build on Node 18 or 20 → Do: Use Node.js 22.18+ (or 24.11+) (The packages need Node 22; older Node gives Turbopack "JSON file not found" errors because require(esm) is missing.)
- Don't: const { loader } = require('fumadocs-core/source') → Do: import { loader } from 'fumadocs-core/source' (All Fumadocs packages are ESM only.)
- Don't: Adding OpenAPI pages to the loader and leaving the docs page and llms routes unchanged → Do: Check page.type === 'openapi' everywhere source is used and render those pages with <OpenAPIPage /> (After the change, source holds two page types and the old code breaks on OpenAPI pages.)
- Don't: Calling docsLlms.page() or docsLlms.full() after llms(source) with no options → Do: Pass renderPage to llms() and turn on includeProcessedMarkdown in source.config.ts (Without renderPage only the index works.)
- Don't: Setting output 'export' and keeping the default search server route as is → Do: Configure the search server and client for static mode so the index is stored as files (The default setup is server-first and needs a running server.)

### Questions
- Which frameworks does it work with? Next.js, React Router, TanStack Start, Waku and Astro with React. Next.js is the makers' choice for new projects.
- Can I host it without a server? Yes. Turn on static export in Next.js and set up static search; the site is then plain HTML files and search runs in the browser.
- Can I add it to an app I already have? Yes. The docs have a manual installation guide for adding Fumadocs to an existing Next.js project.
- Is it free for a paid product? Yes. It is MIT licensed; keep the license notice with the code. No credit on the site is required.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
