Changelog

The latest releases of Fumadocs.

September 2026

Sep 15
@fumadocs/tailwind@0.1.2
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/story@1.3.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
fumadocs-mdx@15.4.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumari/stf@1.1.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/shadcn@0.1.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/satteri@0.5.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/sanity@0.2.3
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/mdx-remote@1.5.2
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/local-md@0.3.5
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumari/image-size@0.1.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/local-html@0.1.3
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/local-content@0.2.2
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/language@0.2.5
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/graphql@0.2.7
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
fumadocs-epub@1.2.2
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
fumadocs-docgen@3.1.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
create-fumadocs-app@16.2.2
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/content@0.1.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/content-collections@1.3.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/cli@1.6.1
Reuse your Shadcn UI components

On projects with a components.json, the CLI leaves the button, popover and collapsible of your ui directory as they are and imports them from installed components, they share the API of Shadcn UI. cn is imported from your utils alias instead of a new lib/cn.ts, configurable in cli.json:
```
{
  "aliases": {
    "utils": "./lib/utils"
  }
}
```
Fumadocs' copies are only installed when you don't have them yet. The tabs and accordion primitives are Fumadocs specific, they are installed next to their components instead of the ui directory.
- customize updates the imports of your route files to the installed layouts.
- feature ai and feature feedback install the primitives of your configured uiLibrary, they always used the Radix UI ones before.
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/basehub@0.1.1
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/asyncapi@0.3.6
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 15
@fumadocs/api-docs@0.2.9
Mark packages side-effect free

All packages now declare sideEffects in package.json, so bundlers can tree-shake unused modules. Packages shipping stylesheets list them as side effects to keep CSS imports.
Sep 13
fumadocs@16.15.10
- @fumadocs/base-ui@16.15.10
- fumadocs-core@16.15.10
- fumadocs-ui@16.15.10
Fix language switching with hidden locale prefixes

Root Provider's i18n option now accepts defaultLanguage and hideLocale. The language switcher uses these options instead of guessing from the current URL, so switching from /zh/docs to the default language en with hideLocale: 'default-locale' navigates to /docs.

i18nProvider() and defineI18nUI() pass these options from your i18n config automatically.

Fix same-page anchors on Tanstack Start

Tanstack Router's Link takes a pathname in to and reads the hash from a separate hash prop, so a same-page anchor like [link](#installation) was rendered as a link to the current page with the hash dropped, clicking it did nothing. The Tanstack adapter now renders a native <a> for those hrefs:
```
Jump to [Installation](#installation).
```
Sep 13
create-fumadocs-app@16.2.1
Published create-fumadocs-app@16.2.1.
Sep 10
fumadocs-preview@0.2.2
CLIs on cac

The CLIs are now built on cac.
Sep 10
create-fumadocs-app@16.2.0
Search providers and shared CLI features

--search accepts algolia, typesense and mixedbread in addition to orama and orama-cloud.

Search, linter, OG image and Ask AI options are now applied by the features of @fumadocs/cli, the same code that configures them on an existing app, instead of template plugins. create-fumadocs-versions pins the versions of the new search dependencies.

CLIs on cac

The CLIs are now built on cac.
Sep 10
fumadocs@16.15.9
- @fumadocs/base-ui@16.15.9
- fumadocs-core@16.15.9
- fumadocs-ui@16.15.9
getPageByUrl() on the loader

Look up a page by its URL:
```
source.getPageByUrl('/docs/getting-started');
source.getPageByUrl('/cn/docs/getting-started', 'cn');
```
Without the language argument every language is looked up, unlike getPageByHref() which resolves the default language only.

llms() renders pages

llms() used to build the llms.txt index only, turning a page into Markdown was left to your own getLLMText(). Pass renderPage and it covers both:
```
import { llms } from 'fumadocs-core/source';

export const docsLlms = llms(source, {
  renderPage: async (page) => `# ${page.data.title} (${page.url})

${await page.data.getText('processed')}`,
});
```
- page(page) renders one page, for the per-page Markdown route.
- full(lang?) renders every page and joins them, for llms-full.txt.
```
// app/llms-full.txt/route.ts
export const GET = async () => new Response(await docsLlms.full());
```
Both methods exist only when renderPage is given, in types and at runtime. Fumadocs cannot know how your content source exposes Markdown: page.data.getText('processed') on Fumadocs MDX, page.data.content on @fumadocs/local-md.

fumadocs-core/mcp: docs tools for your MCP server

Register the docs tools on a server you own, rather than on a handler Fumadocs builds for you:
```
import { createMcpHandler, McpServer } from '@modelcontextprotocol/server';
import { registerSearchTool, registerSourceTools } from 'fumadocs-core/mcp';
import { createFromSource } from 'fumadocs-core/search/server';
import { docsLlms, source } from '@/lib/source';

const handler = createMcpHandler(() => {
  const mcp = new McpServer({ name: 'docs', version: '1.0.0' });

  registerSourceTools(mcp, source, docsLlms);
  registerSearchTool(mcp, createFromSource(source));

  return mcp;
});

export const GET = (req: Request) => handler.fetch(req);
export const POST = (req: Request) => handler.fetch(req);
export const DELETE = (req: Request) => handler.fetch(req);
```
Function Tools
registerSourceTools(mcp, source, llms) list_pages, get_page
registerSearchTool(mcp, server) search

Each takes the integration it reads from, so you can add your own tools next to them, point the search tool at another server, or register only one of the two.

@modelcontextprotocol/server is an optional peer dependency, and registerSourceTools needs a llms() output with renderPage.

toDocuments() for Algolia and Orama Cloud

Build the search indexes of every page, instead of mapping pages by hand:
```
// app/static.json/route.ts
import { toDocuments } from 'fumadocs-core/search/algolia';
import { source } from '@/lib/source';

export const GET = async () => Response.json(await toDocuments(source));
```
It awaits structuredData when your collection is async (React Router and TanStack Start), a step that was easy to miss. Pass tag to filter results by a value of your choice:
```
toDocuments(source, { tag: (page) => page.slugs[0] });
```
Exported from fumadocs-core/search/algolia and fumadocs-core/search/orama-cloud.

Marked as side-effect free

fumadocs-core now declares "sideEffects": false. No module in the package imports for side effects or ships CSS, so bundlers that rely on the hint (webpack in particular) can drop unused modules instead of keeping them alive:
```
import { createGetUrl } from 'fumadocs-core/source';
```

Function	Tools
`registerSourceTools(mcp, source, llms)`	`list_pages`, `get_page`
`registerSearchTool(mcp, server)`	`search`

Sep 10

fumadocs-openapi@11.4.2

`path` in operation renderers

renderOperationLayout and generateCodeSamples now receive the operation's path, so custom layouts no longer need a React context to reach it:

renderOperationLayout: (slots, { path, method }) => (
  <div>
    {slots.header}
    <EndpointPreview path={path} method={method} />
    {slots.description}
    {slots.apiPlayground}
  </div>
);

Sep 10
fumadocs-epub@1.2.1
createEpubExportAPI()

A route handler for the EPUB export, replacing the auth check and response headers you had to write yourself:
```
// app/export/epub/route.ts
import { createEpubExportAPI } from 'fumadocs-epub';
import { source } from '@/lib/source';

export const { GET } = createEpubExportAPI({
  source,
  title: 'Documentation',
  author: 'Your Team',
  secret: process.env.EXPORT_SECRET,
});
```
secret is required: requests must send Authorization: Bearer <secret>, and the route answers 503 while the secret itself is unset, so a missing environment variable cannot leave the export open. It also takes filename (default docs.epub) and every option of exportEpub(), which stays available for public routes and scripts.

Changelog

September 2026

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Reuse your Shadcn UI components

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Mark packages side-effect free

Fix language switching with hidden locale prefixes

Fix same-page anchors on Tanstack Start

CLIs on cac

Search providers and shared CLI features

CLIs on cac

getPageByUrl() on the loader

llms() renders pages

fumadocs-core/mcp: docs tools for your MCP server

toDocuments() for Algolia and Orama Cloud

Marked as side-effect free

path in operation renderers

createEpubExportAPI()

Reuse your Shadcn UI components

Mark packages side-effect free

Fix language switching with hidden locale prefixes

Fix same-page anchors on Tanstack Start

Search providers and shared CLI features

CLIs on cac

getPageByUrl() on the loader

llms() renders pages

fumadocs-core/mcp: docs tools for your MCP server

toDocuments() for Algolia and Orama Cloud

Marked as side-effect free

path in operation renderers

createEpubExportAPI()

CLIs on `cac`

CLIs on `cac`

`getPageByUrl()` on the loader

`llms()` renders pages

`fumadocs-core/mcp`: docs tools for your MCP server

`toDocuments()` for Algolia and Orama Cloud

`path` in operation renderers

`createEpubExportAPI()`

CLIs on `cac`

`getPageByUrl()` on the loader

`llms()` renders pages

`fumadocs-core/mcp`: docs tools for your MCP server

`toDocuments()` for Algolia and Orama Cloud

`path` in operation renderers

`createEpubExportAPI()`