Changelog

The latest releases of Fumadocs.

November 2025

Nov 7
fumadocs-openapi@10.0.1
Patch Changes
- 2347d33: Fix Scalar integration
Nov 7
fumadocs-core@16.0.8
Patch Changes
- bc97236: Fix rehypeCode() tsdoc for lazy option
- ca09b6a: Core: Support accessing MDX plugins separately at fumadocs-core/mdx-plugins/*
- 117ad86: Add support for using a custom GitHub API base URL

Nov 7

fumadocs-openapi@10.0.0

Major Changes

ccae0ac: Rename option content.showExampleInFields to schemaUI.showExample.

87cdffa: Drop renderer & fields API

Fumadocs OpenAPI now expects per-feature customizations, dropping the old centralized renderer API.

// components/api-page.tsx
import { openapi } from '@/lib/openapi';
import { createAPIPage } from 'fumadocs-openapi/ui';

export const APIPage = createAPIPage(openapi, {
  // e.g. customise render functions
  content: {
    renderResponseTabs,
    renderAPIExampleLayout,
    renderAPIExampleUsageTabs,
  },
});

For migrating the fields option of Playground, you can use render* APIs on client configs.

// components/api-page.client.tsx
'use client';
import { defineClientConfig } from 'fumadocs-openapi/ui/client';

export default defineClientConfig({
  playground: {
    renderParameterField: (fieldName, field) => ...
  }
})

You can customise the renderers of different layouts:

// components/api-page.tsx
import { openapi } from '@/lib/openapi';
import { createAPIPage } from 'fumadocs-openapi/ui';

export const APIPage = createAPIPage(openapi, {
  content: {
    renderResponseTabs: (tabs) => <div></div>,
    renderAPIExampleLayout: ({ selector, usageTabs, responseTabs }) => (
      <div></div>
    ),
    renderAPIExampleUsageTabs: (generators) => <div></div>,
    renderPageLayout: ({ operations, webhooks }) => <div></div>,
    renderOperationLayout: (slots) => <div></div>,
    renderWebhookLayout: ({
      header,
      authSchemes,
      paremeters,
      body,
      responses,
      callbacks,
    }) => <div></div>,
  },
});

40d0fa3: Expect OpenAPI server to use generateFiles()

File generation is now part of OpenAPI server, the input field requires the server instead of string array.

Before:

import { openapi } from '@/lib/openapi';

void generateFiles({
  input: ['./products.yaml'],
  output: './content/docs',
});

After:

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

void generateFiles({
  input: openapi,
  output: './content/docs',
});

aa4e1ad: Redesign createOpenAPI usage

Isolate API page and API server.

Before:

// lib/openapi.ts
import { createOpenAPI } from 'fumadocs-openapi/server';
import path from 'node:path';

export const openapi = createOpenAPI({
  input: [path.resolve('./scalar.yaml')],
  proxyUrl: '/api/proxy',

  mediaAdapters: { ... },
  shikiOptions: {
    themes: {
      dark: 'vesper',
      light: 'vitesse-light',
    },
  },
});

After:

// lib/openapi.ts
import { createOpenAPI } from 'fumadocs-openapi/server';
import path from 'node:path';

export const openapi = createOpenAPI({
  input: [path.resolve('./scalar.yaml')],
  proxyUrl: '/api/proxy',
});

// components/api-page.tsx
import { openapi } from '@/lib/openapi';
import { createAPIPage } from 'fumadocs-openapi/ui';

export const APIPage = createAPIPage(openapi, {
  mediaAdapters: { ... },
  shikiOptions: {
    themes: {
      dark: 'vesper',
      light: 'vitesse-light',
    },
  },
});

Remove disablePlayground from createAPIPage(), use playground.enabled instead:

// components/api-page.tsx
import { openapi } from '@/lib/openapi';
import { createAPIPage } from 'fumadocs-openapi/ui';

export const APIPage = createAPIPage(openapi, {
  playground: {
    enabled: false,
  },
});

Support client config:

// components/api-page.tsx
import { openapi } from '@/lib/openapi';
import { createAPIPage } from 'fumadocs-openapi/ui';
import client from './api-page.client';

export const APIPage = createAPIPage(openapi, {
  client,
});

// components/api-page.client.tsx
'use client';
import { defineClientConfig } from 'fumadocs-openapi/ui/client';

export default defineClientConfig({
  playground: {
    transformAuthInputs: (inputs) => [
      ...inputs,
      {
        fieldName: 'auth.tests',
        children: <div>Tests</div>,
        defaultValue: '',
      },
    ],
  },
});

Prefer client config for adapter.client:

Forwarding client-side media adapters is also done with api-page.client.tsx:

// components/api-page.tsx
import { openapi } from '@/lib/openapi';
import { createAPIPage } from 'fumadocs-openapi/ui';
import { adapters } from './my-media-adapters';
import client from './api-page.client';

export const APIPage = createAPIPage(openapi, {
  client,
  mediaAdapters: adapters,
});

// components/api-page.client.tsx
'use client';
import { defineClientConfig } from 'fumadocs-openapi/ui/client';
import { adapters } from './my-media-adapters';

export default defineClientConfig({
  mediaAdapters: adapters,
});

Minor Changes

189028a: Add storageKeyPrefix option to isolate localStorage for multiple API instances

When using multiple createOpenAPI() instances in the same application, the server selection state would bleed between different APIs because they all shared the same storage key prefix. Set a prefix to avoid this.

Usage:
```
// components/api-page.client.tsx
'use client';
import { defineClientConfig } from 'fumadocs-openapi/ui/client';

export default defineClientConfig({
  storageKeyPrefix: 'fumadocs-openapi-custom-',
});
```

Patch Changes

c1026b8: Fix TypeScript schema wrong output.

Note: code formatting has been disabled to improve performance.
ca09b6a: Core: Support accessing MDX plugins separately at fumadocs-core/mdx-plugins/*
Updated dependencies [bc97236]
Updated dependencies [ca09b6a]
Updated dependencies [c0df2c4]
Updated dependencies [117ad86]
- fumadocs-core@16.0.8
- fumadocs-ui@16.0.8

Nov 7
fumadocs-twoslash@3.1.10
Patch Changes
- 7c7e984: Fix accessibility: Replace span with button for twoslash hover triggers to resolve critical aria-allowed-attr violations
- bc97236: bump deps
- Updated dependencies [c0df2c4]
- Updated dependencies [117ad86]
  - fumadocs-ui@16.0.8
Nov 7
fumadocs-docgen@3.0.4
Patch Changes
- ca09b6a: Core: Support accessing MDX plugins separately at fumadocs-core/mdx-plugins/*
- Updated dependencies [bc97236]
- Updated dependencies [ca09b6a]
- Updated dependencies [117ad86]
  - fumadocs-core@16.0.8
Nov 7
fumadocs-obsidian@0.0.6
Patch Changes
- ca09b6a: Core: Support accessing MDX plugins separately at fumadocs-core/mdx-plugins/*
- Updated dependencies [bc97236]
- Updated dependencies [ca09b6a]
- Updated dependencies [c0df2c4]
- Updated dependencies [117ad86]
  - fumadocs-core@16.0.8
  - fumadocs-ui@16.0.8
Nov 7
create-fumadocs-app@16.0.11
Nov 3
fumadocs-mdx@13.0.5
Patch Changes
- ad38466: add support next.config.mts for mdx
Nov 3
create-fumadocs-app@16.0.10
Nov 1
fumadocs-ui@16.0.7
Patch Changes
- Updated dependencies [f97cd1e]
- Updated dependencies [f7e15e2]
  - fumadocs-core@16.0.7
Nov 1
create-fumadocs-app@16.0.9
Nov 1
fumadocs-core@16.0.7
Patch Changes
- f97cd1e: Support exportAs in remarkStructure.
- f7e15e2: Support timeout in remark image options
Nov 1
fumadocs-mdx@13.0.4
Patch Changes
- 27fc4ed: [Internal] improve mutability of LoadedConfig for plugins
- f5bc4aa: Fix Bun missing query strings
- 61b90c8: Always transform meta files in collection, this includes runtime loaders like Node.js and Bun.
- d1e43f4: Support re-generating index file when using runtime: bun | node
- Updated dependencies [f97cd1e]
- Updated dependencies [f7e15e2]
  - fumadocs-core@16.0.7
Nov 1
fumadocs-openapi@9.7.3
Patch Changes
- Updated dependencies [f97cd1e]
- Updated dependencies [f7e15e2]
  - fumadocs-core@16.0.7
  - fumadocs-ui@16.0.7

October 2025

Oct 29
create-fumadocs-app@16.0.7
Oct 28
fumadocs-openapi@9.7.1
Patch Changes
- Updated dependencies [8221785]
  - fumadocs-core@16.0.5
  - fumadocs-ui@16.0.5
Oct 28
fumadocs-ui@16.0.5
Patch Changes
- Updated dependencies [8221785]
  - fumadocs-core@16.0.5
Oct 28
fumadocs-core@16.0.5
Patch Changes
- 8221785: hotfix i18n middleware URL formating
Oct 28
create-fumadocs-app@16.0.6
Patch Changes
- 3668baf: bump deps & update templates
- eece4f8: Support Tanstack Start SPA
Oct 28
fumadocs-openapi@9.7.0
Minor Changes
- ef73516: Support per: custom
Oct 27
create-fumadocs-app@16.0.5
Oct 27
fumadocs-core@16.0.4
Patch Changes
- 99971c7: Support external: to mark links as external in meta.json
Oct 27
fumadocs-openapi@9.6.5
Patch Changes
- d9d73f3: Support groupBy function value
- Updated dependencies [99971c7]
  - fumadocs-core@16.0.4
  - fumadocs-ui@16.0.4
Oct 27
fumadocs-ui@16.0.4
Patch Changes
- Updated dependencies [99971c7]
  - fumadocs-core@16.0.4
Oct 26
fumapress@0.0.8
Patch Changes
- Updated dependencies [ee4ad3d]
  - fumadocs-mdx@13.0.2
Oct 26
fumadocs-mdx@13.0.2
Patch Changes
- ee4ad3d: Always format file paths into POSIX for Vite
Oct 26
create-fumadocs-app@16.0.4
Patch Changes
- 33c4129: Support CI environment variable, remove negatives options from CLI usage
Oct 25
fumadocs-openapi@9.6.4
Patch Changes
- fumadocs-core@16.0.3
- fumadocs-ui@16.0.3
Oct 25
fumadocs-ui@16.0.3
Patch Changes
- fumadocs-core@16.0.3
Oct 25
fumapress@0.0.7
Patch Changes
- Updated dependencies [56332df]
- Updated dependencies [91add4f]
- Updated dependencies [cffd4c2]
  - fumadocs-mdx@13.0.1
  - fumadocs-core@16.0.3
  - fumadocs-ui@16.0.3