Changelog

The latest releases of Fumadocs.

October 2025

Oct 25
fumadocs-core@16.0.3
Oct 25
fumadocs-mdx@13.0.1
Patch Changes
- 56332df: Support plugins in Webpack loader environment: now plugins can apply changes on MDX options too.
- 91add4f: Plugin json-schema: support inserting $schema to JSON files
- cffd4c2: Lazy update index files on Next.js
  - fumadocs-core@16.0.3
Oct 25
create-fumadocs-app@16.0.3
Patch Changes
- 0ac2f82: Use smarter AST transform for modifying app configs
- 0ac2f82: fix type info lost on create
Oct 24
fumadocs-openapi@9.6.3
Patch Changes
- cc179fb: Generate Python objects for code examples
Oct 23
fumadocs-core@16.0.2
Patch Changes
- d511232: Fix i18n middleware search params handling
Oct 23
fumapress@0.0.6
Patch Changes
- Updated dependencies [d511232]
  - fumadocs-core@16.0.2
  - fumadocs-ui@16.0.2
Oct 23
fumadocs-openapi@9.6.2
Patch Changes
- Updated dependencies [d511232]
  - fumadocs-core@16.0.2
  - fumadocs-ui@16.0.2
Oct 23
fumadocs-obsidian@0.0.5
Patch Changes
- 845075f: Enable remark-gfm by default
- Updated dependencies [d511232]
  - fumadocs-core@16.0.2
  - fumadocs-ui@16.0.2
Oct 23
fumadocs-ui@16.0.2
Patch Changes
- Updated dependencies [d511232]
  - fumadocs-core@16.0.2
Oct 23
create-fumadocs-app@16.0.2
Patch Changes
- 91d7509: Support Orama Cloud template
- d20e90a: Add SPA template for React Router
Oct 22
create-fumadocs-app@16.0.1
Oct 22
fumadocs-openapi@9.6.1
Patch Changes
- Updated dependencies [45f0c1f]
  - fumadocs-core@16.0.1
  - fumadocs-ui@16.0.1
Oct 22
fumadocs-ui@16.0.1
Patch Changes
- 45f0c1f: hotfix <DynamicCodeBlock /> Vite + React 19.2 compat issues
- Updated dependencies [45f0c1f]
  - fumadocs-core@16.0.1
Oct 22
fumadocs-core@16.0.1
Patch Changes
- 45f0c1f: hotfix <DynamicCodeBlock /> Vite + React 19.2 compat issues
Oct 22
fumapress@0.0.5
Patch Changes
- Updated dependencies [45f0c1f]
  - fumadocs-core@16.0.1
  - fumadocs-ui@16.0.1
Oct 22
fumadocs-twoslash@3.1.9
Patch Changes
- 5210f18: Support Fumadocs 16 in peerDependencies.
- Updated dependencies [1494340]
- Updated dependencies [de0ce6d]
- Updated dependencies [0ed0ca6]
- Updated dependencies [5210f18]
- Updated dependencies [42f09c3]
- Updated dependencies [5966e23]
  - fumadocs-ui@16.0.0
Oct 22
fumadocs-python@0.0.6
Patch Changes
- 5210f18: Support Fumadocs 16 in peerDependencies.
- Updated dependencies [1494340]
- Updated dependencies [230c6bf]
- Updated dependencies [851897c]
- Updated dependencies [de0ce6d]
- Updated dependencies [4049ccc]
- Updated dependencies [0ed0ca6]
- Updated dependencies [429c41a]
- Updated dependencies [5210f18]
- Updated dependencies [cbc93e9]
- Updated dependencies [42f09c3]
- Updated dependencies [55afd8a]
- Updated dependencies [5966e23]
  - fumadocs-ui@16.0.0
  - fumadocs-core@16.0.0
Oct 22
@fumadocs/content-collections@1.2.4
Patch Changes
- 5210f18: Support Fumadocs 16 in peerDependencies.
- Updated dependencies [230c6bf]
- Updated dependencies [851897c]
- Updated dependencies [4049ccc]
- Updated dependencies [429c41a]
- Updated dependencies [5210f18]
- Updated dependencies [cbc93e9]
- Updated dependencies [42f09c3]
- Updated dependencies [55afd8a]
  - fumadocs-core@16.0.0
Oct 22
fumadocs-mdx@13.0.0
Major Changes
- 8d0c164: Move createMDXSource and resolveFiles from fumadocs-mdx to fumadocs-mdx/runtime/next
- 3caa5cd: Vite: move source.generated.ts to .source/index.ts
  
  Why:
  - with Fumadocs MDX Plugins, we want to unify the output directory across Vite & Next.js.
  - source.generated.ts looks ugly compared by .source.
  Migrate:
  - run dev server/typegen to generate a .source folder.
  - import it over the original source.generated.ts.
  - note that both docs and create-fumadocs-app are updated to .source folder.
Minor Changes
- 29ce826: Support JSON Schema plugin (fumadocs-mdx/plugins/json-schema)
- 3caa5cd: Support Plugins API
  
  Fumadocs MDX is mostly a bundler plugin meant to be used with tools like Vite and Turbopack.
  
  With Fumadocs MDX Plugins, you can extend Fumadocs MDX without worrying the underlying bundler. It is designed for:
  - Generate files from config (e.g. types, index files, JSON schemas)
  - Modify received config
Patch Changes
- 81fa875: Fix includeProcessedMarkdown cannot stringify MDX nodes
- 575cfb8: Include unravel plugin into remark-include parsing step, this ensures the parsed results are consistent with normal MDX.js processor output.
- 1f1c787: Add useContent API to client loader for avoiding Lint errors
- 9051574: Support postprocess.includeMDAST option
- a5df956: Support runtime: bun and runtime: node in Vite index file generation
- 5210f18: Support Fumadocs 16 in peerDependencies.
- Updated dependencies [230c6bf]
- Updated dependencies [851897c]
- Updated dependencies [4049ccc]
- Updated dependencies [429c41a]
- Updated dependencies [5210f18]
- Updated dependencies [cbc93e9]
- Updated dependencies [42f09c3]
- Updated dependencies [55afd8a]
- Updated dependencies [5210f18]
  - fumadocs-core@16.0.0
  - @fumadocs/mdx-remote@1.4.3
Oct 22
@fumadocs/mdx-remote@1.4.3
Patch Changes
- 5210f18: Support Fumadocs 16 in peerDependencies.
- Updated dependencies [230c6bf]
- Updated dependencies [851897c]
- Updated dependencies [4049ccc]
- Updated dependencies [429c41a]
- Updated dependencies [5210f18]
- Updated dependencies [cbc93e9]
- Updated dependencies [42f09c3]
- Updated dependencies [55afd8a]
  - fumadocs-core@16.0.0
Oct 22
fumadocs-obsidian@0.0.4
Patch Changes
- dd88c48: Resolve & transform image urls (such as ![alt](./path.png)).
- 6c30093: Improve internal transformations to unwrap paragraphs
- 254b934: Experimental support for usage without scripts
- 5210f18: Support Fumadocs 16 in peerDependencies.
- Updated dependencies [1494340]
- Updated dependencies [230c6bf]
- Updated dependencies [851897c]
- Updated dependencies [de0ce6d]
- Updated dependencies [4049ccc]
- Updated dependencies [0ed0ca6]
- Updated dependencies [429c41a]
- Updated dependencies [5210f18]
- Updated dependencies [cbc93e9]
- Updated dependencies [42f09c3]
- Updated dependencies [55afd8a]
- Updated dependencies [5966e23]
  - fumadocs-ui@16.0.0
  - fumadocs-core@16.0.0
Oct 22
fumadocs-core@16.0.0
Major Changes
- 851897c: Remove fumadocs-core/sidebar API
  
  why: no longer used by Fumadocs UI, and the abstraction isn't good enough.
  
  migrate: The original component is mostly a wrapper of react-remove-scroll, you can use Shadcn UI for pre-built sidebars.
- 4049ccc: Remove fumadocs-core/server export
  - getGithubLastEdit: Moved to fumadocs-core/content/github.
  - getTableOfContents: Moved to fumadocs-core/content/toc.
  - PageTree and page tree utilities: Moved to fumadocs-core/page-tree.
  - TOCItemType, TableOfContents: Moved to fumadocs-core/toc.
  - createMetadataImage: Use the Next.js Metadata API instead.
- 429c41a: Switch to Shiki JavaScript Regex engine by default
  
  This is important for Cloudflare Worker compatibility, JavaScript engine is the new default over Oniguruma (WASM).
  - rehype-code: replaced the experimentalJSEngine option with engine: js | oniguruma.
  - fumadocs-core/highlight: use JS engine by default, drop custom engine support, use Shiki directly instead.
- 5210f18: Set minimal React.js version to 19.2.0
  
  19.2 has multiple crucial updates that can improve Fumadocs' performance, and it should works seamlessly on mainstream React.js frameworks.
  
  As a consequence, Next.js 16 is now the minimal version when using Fumadocs UI because Next.js always uses the internal canary version of React.js.
- 42f09c3: Remove deprecated APIs
  - fumadocs-ui/page:
    - removed <DocsCategory />.
    - removed breadcrumbs.full option from <DocsPage />.
  - fumadocs-core/search/algolia: renamed option document to indexName.
  - fumadocs-core/search:
    - remove deprecated signature of createFromSource(): migrate to newer usage instead.
      export function createFromSource<S extends LoaderOutput<LoaderConfig>>( source: S, pageToIndexFn?: (page: InferPageType<S>) => Awaitable<AdvancedIndex>, options?: Omit<Options<S>, 'buildIndex'>, ): SearchAPI;
    - remove deprecated parameters in useSearch(), pass them in the client object instead.
  - fumadocs-core/highlight: remove deprecated withPrerenderScript and loading options from useShiki().
  - fumadocs-core/i18n: removed createI18nMiddleware, import from fumadocs-core/i18n/middleware instead.
  - fumadocs-core/source:
    - removed deprecated transformers, pageTree.attach* options from loader().
    - removed deprecated page.file property.
    - removed FileInfo & parseFilePath utilities.
- 55afd8a: Migrate to New Orama Cloud
  
  @orama/core is the new version of Orama Cloud client. See their docs for details.
  
  When using Fumadocs' Orama Cloud integration, you need to use the new client instead:
  import { sync } from 'fumadocs-core/search/orama-cloud'; import { OramaCloud } from '@orama/core'; // update this const orama = new OramaCloud({ projectId: '<project id>', apiKey: '<private api key>', }); await sync(orama, { index: '<data source id>', documents: records, });
Minor Changes
- cbc93e9: Disable single by default on fumadocs-core/toc API
Patch Changes
- 230c6bf: let getPageTreePeers handle i18n
Oct 22
fumadocs-docgen@3.0.3
Patch Changes
- 5210f18: Support Fumadocs 16 in peerDependencies.
- Updated dependencies [230c6bf]
- Updated dependencies [851897c]
- Updated dependencies [4049ccc]
- Updated dependencies [429c41a]
- Updated dependencies [5210f18]
- Updated dependencies [cbc93e9]
- Updated dependencies [42f09c3]
- Updated dependencies [55afd8a]
  - fumadocs-core@16.0.0
Oct 22
fumadocs-typescript@4.0.12
Patch Changes
- 5210f18: Support Fumadocs 16 in peerDependencies.
- Updated dependencies [1494340]
- Updated dependencies [230c6bf]
- Updated dependencies [851897c]
- Updated dependencies [de0ce6d]
- Updated dependencies [4049ccc]
- Updated dependencies [0ed0ca6]
- Updated dependencies [429c41a]
- Updated dependencies [5210f18]
- Updated dependencies [cbc93e9]
- Updated dependencies [42f09c3]
- Updated dependencies [55afd8a]
- Updated dependencies [5966e23]
  - fumadocs-ui@16.0.0
  - fumadocs-core@16.0.0
Oct 22
fumadocs-openapi@9.6.0
Minor Changes
- 8ebd28f: Redesign schema UI to leverage CSR
  
  Fumadocs OpenAPI now uses CSR to render recursive components, hugely reducing the size of page for highly nested JSON schemas & improve performance.
- ef9737d: Add reset value button to non-required fields
Patch Changes
- 21fcc0b: Support content.showExampleInFields option
- 4a36701: avoid render-time form modifications
- 5210f18: Support Fumadocs 16 in peerDependencies.
- Updated dependencies [1494340]
- Updated dependencies [230c6bf]
- Updated dependencies [851897c]
- Updated dependencies [de0ce6d]
- Updated dependencies [4049ccc]
- Updated dependencies [0ed0ca6]
- Updated dependencies [429c41a]
- Updated dependencies [5210f18]
- Updated dependencies [cbc93e9]
- Updated dependencies [42f09c3]
- Updated dependencies [55afd8a]
- Updated dependencies [5966e23]
  - fumadocs-ui@16.0.0
  - fumadocs-core@16.0.0
Oct 22
fumadocs-ui@16.0.0
Major Changes
- 0ed0ca6: Change --fd-layout-width to 1600px by default
  
  This will change the max layout width to 1600px, you can still change it back with:
  :root { --fd-layout-width: 100vw; }
- 5210f18: Set minimal React.js version to 19.2.0
  
  19.2 has multiple crucial updates that can improve Fumadocs' performance, and it should works seamlessly on mainstream React.js frameworks.
  
  As a consequence, Next.js 16 is now the minimal version when using Fumadocs UI because Next.js always uses the internal canary version of React.js.
- 42f09c3: Remove deprecated APIs
  - fumadocs-ui/page:
    - removed <DocsCategory />.
    - removed breadcrumbs.full option from <DocsPage />.
  - fumadocs-core/search/algolia: renamed option document to indexName.
  - fumadocs-core/search:
    - remove deprecated signature of createFromSource(): migrate to newer usage instead.
      export function createFromSource<S extends LoaderOutput<LoaderConfig>>( source: S, pageToIndexFn?: (page: InferPageType<S>) => Awaitable<AdvancedIndex>, options?: Omit<Options<S>, 'buildIndex'>, ): SearchAPI;
    - remove deprecated parameters in useSearch(), pass them in the client object instead.
  - fumadocs-core/highlight: remove deprecated withPrerenderScript and loading options from useShiki().
  - fumadocs-core/i18n: removed createI18nMiddleware, import from fumadocs-core/i18n/middleware instead.
  - fumadocs-core/source:
    - removed deprecated transformers, pageTree.attach* options from loader().
    - removed deprecated page.file property.
    - removed FileInfo & parseFilePath utilities.
Patch Changes
- 1494340: Drop fumadocs-core/hide-if-empty usage, prefer user-side component overrides for precise control
- de0ce6d: Add a toc-title ID to the table of contents heading for styling purposes
- 5966e23: Fix root toggle overflow
- Updated dependencies [230c6bf]
- Updated dependencies [851897c]
- Updated dependencies [4049ccc]
- Updated dependencies [429c41a]
- Updated dependencies [5210f18]
- Updated dependencies [cbc93e9]
- Updated dependencies [42f09c3]
- Updated dependencies [55afd8a]
  - fumadocs-core@16.0.0
Oct 22
@fumadocs/cli@1.0.3
Patch Changes
- 5210f18: Support Fumadocs 16 in peerDependencies.
Oct 22
create-fumadocs-app@16.0.0
Patch Changes
- 4c535f3: fix outdated Tanstack Start template
- 5210f18: Support Fumadocs 16 in peerDependencies.
Oct 6
fumadocs-ui@15.8.4
Patch Changes
- Updated dependencies [ce2be59]
- Updated dependencies [31b9494]
  - fumadocs-core@15.8.4
Oct 6
fumapress@0.0.3
Patch Changes
- Updated dependencies [a55177c]
- Updated dependencies [ce2be59]
- Updated dependencies [31b9494]
  - fumadocs-mdx@12.0.3
  - fumadocs-core@15.8.4
  - fumadocs-ui@15.8.4

Changelog

October 2025

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Major Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Major Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Major Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Major Changes

Minor Changes

Patch Changes

Patch Changes

Major Changes

Minor Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Major Changes

Patch Changes