Changelog

The latest releases of Fumadocs.

June 2025

Jun 6
fumadocs-openapi@9.0.7
Patch Changes
- 77461e5: Fix root schema manipulation with TypeScript definition generation
Jun 5
fumadocs-core@15.5.1
Patch Changes
- b4916d2: Move hide-if-empty component to Fumadocs Core
- 8738b9c: Always encode generated slugs for non-ASCII characters in loader()
- a66886b: Deprecate other parameters for useDocsSearch()
  
  The new usage passes options to a single object, improving the readability:
  import { useDocsSearch } from 'fumadocs-core/search/client'; const { search, setSearch, query } = useDocsSearch({ type: 'fetch', locale: 'optional', tag: 'optional', delayMs: 100, allowEmpty: false, });
Jun 5
fumadocs-mdx@11.6.7
Patch Changes
- a5c283f: Support outDir option on createMDX()
- Updated dependencies [b4916d2]
- Updated dependencies [8738b9c]
- Updated dependencies [a66886b]
  - fumadocs-core@15.5.1
Jun 5
fumadocs-openapi@9.0.6
Patch Changes
- 99e3c95: Consistent URL resolution
- Updated dependencies [b4916d2]
- Updated dependencies [8738b9c]
- Updated dependencies [68526ea]
- Updated dependencies [a66886b]
  - fumadocs-core@15.5.1
  - fumadocs-ui@15.5.1
Jun 5
fumadocs-ui@15.5.1
Patch Changes
- b4916d2: Move hide-if-empty component to Fumadocs Core
- 68526ea: Redesign fumadocs-ui/components/dialog/search usage to make it composable, and mark it as stable API.
- Updated dependencies [b4916d2]
- Updated dependencies [8738b9c]
- Updated dependencies [a66886b]
  - fumadocs-core@15.5.1
Jun 5
create-fumadocs-app@15.5.1
Jun 1
fumadocs-core@15.5.0
Jun 1
fumadocs-ui@15.5.0
Minor Changes
- 589d101: Move TOC closer to page body on larger viewports
  
  Changed layout positioning, all layout components now use fixed position.
  
  This may impact sites that:
  - using custom styling on Fumadocs layouts.
  - added a custom footer (see below).
  For custom footer, make sure to add them into <DocsLayout /> instead:
  <DocsLayout> {children} <div className="h-[400px] bg-fd-secondary">Hello World</div> </DocsLayout>
Patch Changes
- 50f8f7f: Update Home Layout navbar design
- 697d5b4: Support specifying a custom value for Accordion
  - fumadocs-core@15.5.0
Jun 1
create-fumadocs-app@15.5.0
Jun 1
fumadocs-openapi@9.0.5
Patch Changes
- 5067efc: Improved support for all OAuth flows
- Updated dependencies [50f8f7f]
- Updated dependencies [589d101]
- Updated dependencies [697d5b4]
  - fumadocs-ui@15.5.0
  - fumadocs-core@15.5.0

May 2025

May 28
fumadocs-openapi@9.0.4
Patch Changes
- 9721f6f: Introduce allowedOrigins and filterRequest options to createProxy. Deprecate allowedUrls in favour of new APIs.
May 27
fumadocs-openapi@9.0.3
Patch Changes
- 5770180: Implement multiple security schemes support
- d2a2d47: Skip non-required values when generating code examples
- Updated dependencies [0ab6c7f]
  - fumadocs-core@15.4.2
  - fumadocs-ui@15.4.2
May 27
fumadocs-ui@15.4.2
Patch Changes
- Updated dependencies [0ab6c7f]
  - fumadocs-core@15.4.2
May 27
create-fumadocs-app@15.4.2
May 27
fumadocs-core@15.4.2
Patch Changes
- 0ab6c7f: Improve performance by using shallow compare on useOnChange by default
May 26
create-fumadocs-app@15.4.1
May 26
fumadocs-core@15.4.1
May 26
fumadocs-openapi@9.0.2
Patch Changes
- 0a90cb9: Improve auth handling
- Updated dependencies [e72b7b4]
  - fumadocs-ui@15.4.1
  - fumadocs-core@15.4.1
May 26
fumadocs-ui@15.4.1
Patch Changes
- e72b7b4: hotfix: production source map being ignored
  - fumadocs-core@15.4.1
May 26
fumadocs-openapi@9.0.1
Patch Changes
- 2f2ae4d: Disable schema inline on generateFiles()
- 951a1a4: Support overriding request/response from createProxy()
- 2f2ae4d: Support code samples without label
- 2f2ae4d: Hide internal APis since their changes are not documented
May 25
fumadocs-openapi@9.0.0
Major Changes
- bdef238: Redesign generateFiles
  
  This redesign will finalize the behaviour of generateFiles to make it simpler, consistent across different versions of Fumadocs OpenAPI.
  - Abandoned groupByFolder, it's deprecated long time ago and can be replaced with groupBy.
  - Improved type safety, groupBy is now only available with per set to operation.
  - name usage changed (see below).
  The name option was supposed to designate a output path for generated page. Since groupBy was introduced, name became somehow useless because its design doesn't work well with groupBy.
  
  New name Design:
  
  It now accepts a function:
  generateFiles({ input: ['./content/docs/openapi/museum.yaml'], output: './content/docs/openapi/(generated)', per: 'operation', name: (output, document) => { // page info output.item; // parsed OpenAPI schema document; return 'dir/my-file'; }, });
  You can set algorithm to v1 to keep the behaviour of Fumadocs OpenAPI v8:
  generateFiles({ input: ['./content/docs/openapi/museum.yaml'], output: './content/docs/openapi/(generated)', per: 'operation', name: { algorithm: 'v1', }, });
  per: operation:
  
  File name will be identical with your operationId if defined, otherwise fallback to endpoint path or webhook name.
  generateFiles({ input: ['./content/docs/openapi/museum.yaml'], output: './content/docs/openapi/(generated)', per: 'operation', });
  With per: operation, you can use groupBy to group pages:
  - tag: {tag}/{file}
  - route: {endpoint}/{method} (it will ignore the name option)
  - none: {file} (default)
  per: tag | file:
  
  They are unchanged.
Minor Changes
- c945b5f: Mark mediaAdapters API stable
- b0c02a0: Redesign schema display UI
Patch Changes
- 00a81e1: Improve playground body input
- 1bcdc84: Fix recursive reference in anyOf/allOf/oneOf
- Updated dependencies [092fd04]
- Updated dependencies [1b999eb]
- Updated dependencies [961b67e]
- Updated dependencies [7d78bc5]
  - fumadocs-ui@15.4.0
  - fumadocs-core@15.4.0

May 25

fumadocs-ui@15.4.0

Minor Changes

961b67e: Bump algolia search to v5

This also introduced changes to some APIs since algoliasearch v4 and v5 has many differences.

Now we highly recommend to pass an index name to sync():

import { algoliasearch } from 'algoliasearch';
import { sync } from 'fumadocs-core/search/algolia';
const client = algoliasearch('id', 'key');

void sync(client, {
  indexName: 'document',
  documents: records,
});

For search client, pass them to searchOptions:

'use client';

import { liteClient } from 'algoliasearch/lite';
import type { SharedProps } from 'fumadocs-ui/components/dialog/search';
import SearchDialog from 'fumadocs-ui/components/dialog/search-algolia';

const client = liteClient(appId, apiKey);

export default function CustomSearchDialog(props: SharedProps) {
  return (
    <SearchDialog
      searchOptions={{
        client,
        indexName: 'document',
      }}
      {...props}
      showAlgolia
    />
  );
}

Patch Changes

092fd04: Fallback to dangerouslySetInnerHTML for inlined scripts for backward compatibility
7d78bc5: Improve createRelativeLink and getPageByHref for i18n usage
Updated dependencies [1b999eb]
Updated dependencies [961b67e]
Updated dependencies [7d78bc5]
- fumadocs-core@15.4.0

May 25
fumadocs-mdx@11.6.6
Patch Changes
- cd42e78: Support last modified time on Async Mode
- Updated dependencies [1b999eb]
- Updated dependencies [961b67e]
- Updated dependencies [7d78bc5]
  - fumadocs-core@15.4.0

May 25

fumadocs-core@15.4.0

Minor Changes

961b67e: Bump algolia search to v5

This also introduced changes to some APIs since algoliasearch v4 and v5 has many differences.

Now we highly recommend to pass an index name to sync():

import { algoliasearch } from 'algoliasearch';
import { sync } from 'fumadocs-core/search/algolia';
const client = algoliasearch('id', 'key');

void sync(client, {
  indexName: 'document',
  documents: records,
});

For search client, pass them to searchOptions:

'use client';

import { liteClient } from 'algoliasearch/lite';
import type { SharedProps } from 'fumadocs-ui/components/dialog/search';
import SearchDialog from 'fumadocs-ui/components/dialog/search-algolia';

const client = liteClient(appId, apiKey);

export default function CustomSearchDialog(props: SharedProps) {
  return (
    <SearchDialog
      searchOptions={{
        client,
        indexName: 'document',
      }}
      {...props}
      showAlgolia
    />
  );
}

Patch Changes

1b999eb: Introduce <Markdown /> component
7d78bc5: Improve createRelativeLink and getPageByHref for i18n usage

May 25
create-fumadocs-app@15.4.0
May 20
fumadocs-typescript@4.0.5
Patch Changes
- a6c909b: Removed unused devDependencies and migrated from fast-glob to tinyglobby
May 20
fumadocs-openapi@8.1.12
Patch Changes
- a6c909b: Removed unused devDependencies and migrated from fast-glob to tinyglobby
- Updated dependencies [e0c2a92]
- Updated dependencies [71fc1a5]
  - fumadocs-ui@15.3.4
  - fumadocs-core@15.3.4
May 20
fumadocs-ui@15.3.4
Patch Changes
- e0c2a92: Improve UI consistency
- 71fc1a5: Mount all children of tabs by default
  - fumadocs-core@15.3.4
May 20
fumadocs-core@15.3.4
May 20
fumadocs-mdx@11.6.5
Patch Changes
- a6c909b: Removed unused devDependencies and migrated from fast-glob to tinyglobby
- Updated dependencies [a6c909b]
  - @fumadocs/mdx-remote@1.3.2
  - fumadocs-core@15.3.4

Changelog

June 2025

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

May 2025

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Major Changes

Minor Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Major Changes

Minor Changes

Patch Changes

Minor Changes

Patch Changes

Minor Changes

Patch Changes