Changelog

The latest releases of Fumadocs.

August 2025

Aug 28
fumadocs-core@15.7.4
Aug 28
create-fumadocs-app@15.7.4
Aug 27
create-fumadocs-app@15.7.3
Aug 27
fumadocs-core@15.7.3
Patch Changes
- 6d97379: unify remark nodes parsing & improve types
- e776ee5: Fix langAlias not being passed to Shiki rehype plugin
Aug 27
fumadocs-mdx@11.8.1
Patch Changes
- 5f2ec6e: Fix remark-mdx-exports plugin fallback
- Updated dependencies [6d97379]
- Updated dependencies [e776ee5]
  - fumadocs-core@15.7.3
Aug 27
fumadocs-ui@15.7.3
Patch Changes
- f6de900: Add overscroll to sidebar viewports
- Updated dependencies [6d97379]
- Updated dependencies [e776ee5]
  - fumadocs-core@15.7.3
Aug 27
fumadocs-openapi@9.3.0
Minor Changes
- 22371ce: Support index generation in generateFiles: create index files to link all generated pages.
Patch Changes
- 3d3790b: Use schema ID for anti-circular reference
- Updated dependencies [f6de900]
- Updated dependencies [6d97379]
- Updated dependencies [e776ee5]
  - fumadocs-ui@15.7.3
  - fumadocs-core@15.7.3
Aug 24
fumadocs-openapi@9.2.3
Patch Changes
- Updated dependencies [88b5a4e]
- Updated dependencies [039b24b]
- Updated dependencies [08eee2b]
  - fumadocs-core@15.7.2
  - fumadocs-ui@15.7.2
Aug 24
fumadocs-core@15.7.2
Patch Changes
- 88b5a4e: Fix duplicate pages in page tree when referencing subpage in meta.json and using ... or adding the subfolder again
- 039b24b: Fix failed to update page tree from loader()
- 08eee2b: [remark-npm] Enable npm install prefix fallback only on old alias
Aug 24
fumadocs-ui@15.7.2
Patch Changes
- Updated dependencies [88b5a4e]
- Updated dependencies [039b24b]
- Updated dependencies [08eee2b]
  - fumadocs-core@15.7.2
Aug 24
create-fumadocs-app@15.7.2
Aug 24
fumadocs-docgen@3.0.0
Major Changes
- b4474cf: remarkTypeScriptToJavaScript now output new <CodeBlockTabs /> syntax, drop Tab and Tabs options
- b4474cf: Make fumadocs-core a required peer dep (and must be ^15.7.2)
Minor Changes
- b4474cf: [remarkTypeScriptToJavaScript] Support overriding output codeblock's meta string
Patch Changes
- Updated dependencies [88b5a4e]
- Updated dependencies [039b24b]
- Updated dependencies [08eee2b]
  - fumadocs-core@15.7.2
Aug 22
fumadocs-openapi@9.2.2
Patch Changes
- Updated dependencies [195b090]
- Updated dependencies [e1c84a2]
- Updated dependencies [b4e6147]
  - fumadocs-core@15.7.1
  - fumadocs-ui@15.7.1
Aug 22
fumadocs-core@15.7.1
Patch Changes
- 195b090: Support a list of source for loader() API
- e1c84a2: Support fallbackLanguage for loader() i18n API
Aug 22
create-fumadocs-app@15.7.1
Aug 22
fumadocs-ui@15.7.1
Patch Changes
- b4e6147: Fix sidebar & animation bugs
- Updated dependencies [195b090]
- Updated dependencies [e1c84a2]
  - fumadocs-core@15.7.1

Aug 21

fumadocs-core@15.7.0

Minor Changes

514052e: Include locale code into page.path

Previously when i18n is enabled, page.path is not equal to the virtual file paths you passed into loader():

const source = loader({
  source: {
    files: [
      {
        path: 'folder/index.cn.mdx',
        // ...
      },
    ],
  },
});

console.log(source.getPages('cn'));
// path: folder/index.mdx

This can be confusing, the only solution to obtain the original path was page.absolutePath.

From now, the page.path will also include the locale code:

const source = loader({
  source: {
    files: [
      {
        path: 'folder/index.cn.mdx',
        // ...
      },
    ],
  },
});

console.log(source.getPages('cn'));
// path: folder/index.cn.mdx

While this change doesn't affect intended API usages, it may lead to minor bugs when advanced usage/hacks involved around page.path.

e785f98: Introduce page tree fallback API

Page tree is a tree structure.

Previously, when an item is excluded from page tree, it is isolated entirely that you cannot display it at all.

With the new fallback API, isolated pages will go into fallback page tree instead:
```
{
  "children": [
    {
      "type": "page",
      "name": "Introduction"
    }
  ],
  "fallback": {
    "children": [
      {
        "type": "page",
        "name": "Hidden Page"
      }
    ]
  }
}
```
Items in fallback are invisible unless you've opened its item.

0531bf4: Introduce page tree transformer API

You can now define page tree transformer.

export const source = loader({
  // ...
  pageTree: {
    transformers: [
      {
        root(root) {
          return root;
        },
        file(node, file) {
          return node;
        },
        folder(node, dir, metaPath) {
          return node;
        },
        separator(node) {
          return node;
        },
      },
    ],
  },
});

50eb07f: Support type-safe i18n config

// lib/source.ts
import { defineI18n } from 'fumadocs-core/i18n';

export const i18n = defineI18n({
  defaultLanguage: 'en',
  languages: ['en', 'cn'],
});

// root layout
import { defineI18nUI } from 'fumadocs-ui/i18n';
import { i18n } from '@/lib/i18n';

const { provider } = defineI18nUI(i18n, {
  translations: {
    cn: {
      displayName: 'Chinese',
      search: 'Translated Content',
    },
    en: {
      displayName: 'English',
    },
  },
});

function RootLayout({ children }: { children: React.ReactNode }) {
  return <RootProvider i18n={provider(lang)}>{children}</RootProvider>;
}

Although optional, we highly recommend you to refactor the import to i18n middleware:

// here!
import { createI18nMiddleware } from 'fumadocs-core/i18n/middleware';
import { i18n } from '@/lib/i18n';

export default createI18nMiddleware(i18n);

Patch Changes

e254c65: Simplify Source API storage management
ec75601: Support ReactNode for icons in page tree
67df155: createFromSource support async buildIndex and Fumadocs MDX Async Mode
b109d06: Redesign useShiki & <DynamicCodeBlock /> to use React 19 hooks

Aug 21
fumadocs-mdx@11.8.0
Minor Changes
- cfe2a5c: Support Async Mode for Vite
Patch Changes
- c8f49d8: Include frontmatter into page.data.content by default
- Updated dependencies [514052e]
- Updated dependencies [e254c65]
- Updated dependencies [ec75601]
- Updated dependencies [e785f98]
- Updated dependencies [0531bf4]
- Updated dependencies [50eb07f]
- Updated dependencies [67df155]
- Updated dependencies [b109d06]
  - fumadocs-core@15.7.0

Aug 21

fumadocs-ui@15.7.0

Minor Changes

e785f98: Introduce page tree fallback API

Page tree is a tree structure.

Previously, when an item is excluded from page tree, it is isolated entirely that you cannot display it at all.

With the new fallback API, isolated pages will go into fallback page tree instead:
```
{
  "children": [
    {
      "type": "page",
      "name": "Introduction"
    }
  ],
  "fallback": {
    "children": [
      {
        "type": "page",
        "name": "Hidden Page"
      }
    ]
  }
}
```
Items in fallback are invisible unless you've opened its item.

50eb07f: Support type-safe i18n config

// lib/source.ts
import { defineI18n } from 'fumadocs-core/i18n';

export const i18n = defineI18n({
  defaultLanguage: 'en',
  languages: ['en', 'cn'],
});

// root layout
import { defineI18nUI } from 'fumadocs-ui/i18n';
import { i18n } from '@/lib/i18n';

const { provider } = defineI18nUI(i18n, {
  translations: {
    cn: {
      displayName: 'Chinese',
      search: 'Translated Content',
    },
    en: {
      displayName: 'English',
    },
  },
});

function RootLayout({ children }: { children: React.ReactNode }) {
  return <RootProvider i18n={provider(lang)}>{children}</RootProvider>;
}

Although optional, we highly recommend you to refactor the import to i18n middleware:

// here!
import { createI18nMiddleware } from 'fumadocs-core/i18n/middleware';
import { i18n } from '@/lib/i18n';

export default createI18nMiddleware(i18n);

Patch Changes

b109d06: Redesign useShiki & <DynamicCodeBlock /> to use React 19 hooks
b99cf51: Shadcn UI theme: support sidebar specific colors
Updated dependencies [514052e]
Updated dependencies [e254c65]
Updated dependencies [ec75601]
Updated dependencies [e785f98]
Updated dependencies [0531bf4]
Updated dependencies [50eb07f]
Updated dependencies [67df155]
Updated dependencies [b109d06]
- fumadocs-core@15.7.0

Aug 21
create-fumadocs-app@15.7.0
Aug 21
fumadocs-openapi@9.2.1
Patch Changes
- 2122783: Fix absolute path when input is string/array
- Updated dependencies [514052e]
- Updated dependencies [e254c65]
- Updated dependencies [ec75601]
- Updated dependencies [e785f98]
- Updated dependencies [0531bf4]
- Updated dependencies [50eb07f]
- Updated dependencies [67df155]
- Updated dependencies [b109d06]
- Updated dependencies [b99cf51]
  - fumadocs-core@15.7.0
  - fumadocs-ui@15.7.0
Aug 17
fumadocs-core@15.6.12
Aug 17
fumadocs-ui@15.6.12
Patch Changes
- fe31a72: Fix custom components auto RWD handling for home layout
  - fumadocs-core@15.6.12
Aug 17
create-fumadocs-app@15.6.12

Aug 17

fumadocs-openapi@9.2.0

Minor Changes

2ef7f6b: Introduce input API on createOpenAPI(), unify generateFiles()

Migration: Move the server object from lib/source to lib/openapi

import { createOpenAPI } from 'fumadocs-openapi/server';

export const openapi = createOpenAPI({
  input: ['./my-schema.json'],
});

Use the server object for generateFiles():

import { generateFiles } from 'fumadocs-openapi';
import { openapi } from '@/lib/openapi';

void generateFiles({
  input: openapi,
  output: './content/docs',
  // we recommend to enable it
  // make sure your endpoint description doesn't break MDX syntax.
  includeDescription: true,
});

Patch Changes

Updated dependencies [fe31a72]
- fumadocs-ui@15.6.12
- fumadocs-core@15.6.12

Aug 16
create-fumadocs-app@15.6.11
Aug 16
fumadocs-twoslash@3.1.6
Patch Changes
- 51e6687: Fix popup container styles
- Updated dependencies [6de6ff3]
- Updated dependencies [f0b1fee]
  - fumadocs-ui@15.6.11
Aug 16
fumadocs-ui@15.6.11
Patch Changes
- 6de6ff3: Restrict exports of layouts to avoid projects importing internal/unstable APIs
- f0b1fee: Improve layout component customisation experience by handling RWD automatically
  - fumadocs-core@15.6.11
Aug 16
fumadocs-core@15.6.11
Aug 16
fumadocs-openapi@9.1.13
Patch Changes
- Updated dependencies [6de6ff3]
- Updated dependencies [f0b1fee]
  - fumadocs-ui@15.6.11
  - fumadocs-core@15.6.11

Changelog

August 2025

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Major Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Minor Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Major Changes

Minor Changes

Patch Changes

Minor Changes

Patch Changes

Minor Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes