Changelog

The latest releases of Fumadocs.

August 2024

Aug 5
create-fumadocs-app@13.0.7
Aug 5
fumadocs-core@13.0.7
Patch Changes
- 37bbfff: Improve active anchor observer
Aug 4
fumadocs-ui@13.0.6
Patch Changes
- 1622e36: Fix bug breaking Tailwind CSS IntelliSense VSCode Extension
  - fumadocs-core@13.0.6
Aug 4
fumadocs-openapi@4.4.1
Patch Changes
- Updated dependencies [1622e36]
  - fumadocs-ui@13.0.6
  - fumadocs-core@13.0.6
Aug 4
create-fumadocs-app@13.0.6
Aug 4
fumadocs-core@13.0.6
Aug 3
fumadocs-ui@13.0.5
Patch Changes
- Updated dependencies [2cf65f6]
  - fumadocs-core@13.0.5
Aug 3
fumadocs-openapi@4.4.0
Minor Changes
- b109e44: Improve generated sample requests
Patch Changes
- Updated dependencies [2cf65f6]
  - fumadocs-core@13.0.5
  - fumadocs-ui@13.0.5
Aug 3
fumadocs-core@13.0.5
Patch Changes
- 2cf65f6: Support debounce value on algolia search client
Aug 3
create-fumadocs-app@13.0.5
Aug 2
fumadocs-openapi@4.3.1
Patch Changes
- d987912: Show current request pathname in Playground
- 0146572: Fix empty params
Aug 2
fumadocs-openapi@4.3.0
Minor Changes
- 5acebdd: Support grouping output by folders (per operation)
- 744bd24: Support accessing context information on custom frontmatter
- 6bb9d2d: Support integration with Fumadocs Source API
Patch Changes
- 744bd24: Fix generate files on operation mode
- Updated dependencies [5355391]
  - fumadocs-core@13.0.4
  - fumadocs-ui@13.0.4
Aug 2
fumadocs-ui@13.0.4
Patch Changes
- Updated dependencies [5355391]
  - fumadocs-core@13.0.4
Aug 2
create-fumadocs-app@13.0.4
Aug 2
fumadocs-core@13.0.4
Patch Changes
- 5355391: Support indexing description field on documents
Aug 2
fumadocs-ui@13.0.3
Patch Changes
- Updated dependencies [978342f]
  - fumadocs-core@13.0.3
Aug 2
fumadocs-openapi@4.2.2
Patch Changes
- Updated dependencies [978342f]
  - fumadocs-core@13.0.3
  - fumadocs-ui@13.0.3
Aug 2
fumadocs-core@13.0.3
Patch Changes
- 978342f: Type file system utilities (Note: This is an internal module, you're not supposed to reference it)
Aug 2
create-fumadocs-app@13.0.3
Aug 1
fumadocs-ui@13.0.2
Patch Changes
- Updated dependencies [4819820]
  - fumadocs-core@13.0.2
Aug 1
fumadocs-openapi@4.2.1
Patch Changes
- Updated dependencies [4819820]
  - fumadocs-core@13.0.2
  - fumadocs-ui@13.0.2
Aug 1
create-fumadocs-app@13.0.2
Aug 1
fumadocs-core@13.0.2
Patch Changes
- 4819820: Page Tree Builder: Fallback to page icon when metadata doesn't exist

July 2024

Jul 31
fumadocs-openapi@4.2.0
Minor Changes
- dfcc61f: Implement multipart form data
Patch Changes
- f2b540a: Fix fetch problems on API Playground
Jul 28
fumadocs-mdx@9.0.0
Major Changes
- 1f1989e: Support Fumadocs v13
Patch Changes
- fumadocs-core@13.0.1
Jul 28
fumadocs-openapi@4.1.1
Patch Changes
- fumadocs-core@13.0.1
- fumadocs-ui@13.0.1
Jul 28
fumadocs-ui@13.0.1
Patch Changes
- fumadocs-core@13.0.1

Jul 28

fumadocs-ui@13.0.0

Major Changes

89190ae: Rename prefix option on Tailwind CSS Plugin to cssPrefix

why: The previous name was misleading

migrate: Rename the option.

import { createPreset } from 'fumadocs-ui/tailwind-plugin';

/** @type {import('tailwindcss').Config} */
export default {
  presets: [
    createPreset({
      cssPrefix: 'fd',
    }),
  ],
};

b02eebf: Move keepCodeBlockBackground option to code block component

why: Easier to customise code block styles.

migrate:

Enable keepBackground on <CodeBlock />, and remove deprecated usage.

import { Pre, CodeBlock } from 'fumadocs-ui/components/codeblock';

<MDX
  components={{
    pre: ({ ref: _ref, ...props }) => (
      <CodeBlock keepBackground {...props}>
        <Pre>{props.children}</Pre>
      </CodeBlock>
    ),
  }}
/>;

f868018: Replace secondary link items with icon link items

why: Link items with type secondary has been deprecated long time ago.

migrate: Replace type secondary with icon.

8aebeab: Change usage of I18nProvider

why: Make possible to load translations lazily

migrate:

import { RootProvider } from 'fumadocs-ui/provider';
import type { ReactNode } from 'react';
import { I18nProvider } from 'fumadocs-ui/i18n';

export default function Layout({
  params: { lang },
  children,
}: {
  params: { lang: string };
  children: ReactNode;
}) {
  return (
    <html lang={lang}>
      <body>
        <I18nProvider
          locale={lang}
          // options
          locales={[
            {
              name: 'English',
              locale: 'en',
            },
            {
              name: 'Chinese',
              locale: 'cn',
            },
          ]}
          // translations
          translations={
            {
              cn: {
                toc: '目錄',
                search: '搜尋文檔',
                lastUpdate: '最後更新於',
                searchNoResult: '沒有結果',
                previousPage: '上一頁',
                nextPage: '下一頁',
              },
            }[lang]
          }
        >
          <RootProvider>{children}</RootProvider>
        </I18nProvider>
      </body>
    </html>
  );
}

8aebeab: Require locale prop on I18nProvider

why: Fix problems related to pathname parsing

migrate: Pass locale parameter to the provider
0377bb4: Rename id prop on Tabs component to groupId

why: Conflicted with HTML id attribute.

migrate: Rename to groupId.
e8e6a17: Make Tailwind CSS Plugin ESM-only

why: Tailwind CSS supported ESM and TypeScript configs.

migrate: Use ESM syntax in your Tailwind CSS config.
c901e6b: Remove deprecated fumadocs-ui/components/api components

why: The new OpenAPI integration has its own UI implementation.

migrate: Update to latest OpenAPI integration.
89190ae: Add fd- prefix to all Fumadocs UI colors, animations and utilities

why: The added Tailwind CSS colors may conflict with the existing colors of codebases.

migrate: Enable addGlobalColors on Tailwind CSS Plugin or add the fd- prefix to class names.
```
import { createPreset } from 'fumadocs-ui/tailwind-plugin';

/** @type {import('tailwindcss').Config} */
export default {
  presets: [
    createPreset({
      addGlobalColors: true,
    }),
  ],
};
```

b02eebf: Change code block component usage

why: The previous usage was confusing, some props are passed directly to pre while some are not.

migrate:

Pass all props to CodeBlock component. This also includes class names, change your custom styles if necessary.

import { Pre, CodeBlock } from 'fumadocs-ui/components/codeblock';

<MDX
  components={{
    // HTML `ref` attribute conflicts with `forwardRef`
    pre: ({ ref: _ref, ...props }) => (
      <CodeBlock {...props}>
        <Pre>{props.children}</Pre>
      </CodeBlock>
    ),
  }}
/>;

You can ignore this if you didn't customise the default pre element.

4373231: Remove RollButton component

why: RollButton was created because there were no "Table Of Contents" on mobile viewports. Now users can use the TOC Popover to switch between headings, RollButton is no longer a suitable design for Fumadocs UI.

migrate: Remove usages, you may copy the last implementation of RollButton.

Minor Changes

c684c00: Support to disable container style overriding
c8964d3: Include Callout as default MDX component

Patch Changes

daa7d3c: Fix empty folder animation problems
Updated dependencies [09c3103]
Updated dependencies [c714eaa]
Updated dependencies [b02eebf]
- fumadocs-core@13.0.0

Jul 28
fumadocs-twoslash@1.1.1
Patch Changes
- 6ed95ea: Fix compatibility issues with Fumadocs UI v13
- Updated dependencies [89190ae]
- Updated dependencies [b02eebf]
- Updated dependencies [f868018]
- Updated dependencies [8aebeab]
- Updated dependencies [c684c00]
- Updated dependencies [8aebeab]
- Updated dependencies [0377bb4]
- Updated dependencies [e8e6a17]
- Updated dependencies [c8964d3]
- Updated dependencies [c901e6b]
- Updated dependencies [daa7d3c]
- Updated dependencies [89190ae]
- Updated dependencies [b02eebf]
- Updated dependencies [4373231]
  - fumadocs-ui@13.0.0
Jul 28
fumadocs-openapi@4.1.0
Minor Changes
- abf84bb: Support to customise/disable TypeScript Response generation
- 40728a1: Support custom fields (auth, query, header, path and body)
Patch Changes
- Updated dependencies [89190ae]
- Updated dependencies [b02eebf]
- Updated dependencies [09c3103]
- Updated dependencies [f868018]
- Updated dependencies [8aebeab]
- Updated dependencies [c684c00]
- Updated dependencies [8aebeab]
- Updated dependencies [0377bb4]
- Updated dependencies [e8e6a17]
- Updated dependencies [c8964d3]
- Updated dependencies [c901e6b]
- Updated dependencies [daa7d3c]
- Updated dependencies [c714eaa]
- Updated dependencies [89190ae]
- Updated dependencies [b02eebf]
- Updated dependencies [b02eebf]
- Updated dependencies [4373231]
  - fumadocs-ui@13.0.0
  - fumadocs-core@13.0.0