Skip to Content
Fumadocs

Upgrading

Update Fumadocs packages to their latest versions.

Upgrade all Fumadocs packages together. Fumadocs UI has a peer dependency on the exact fumadocs-core version it was released with.

These commands upgrade every fumadocs-* and @fumadocs/* package, and keep the fumadocs-ui alias to @fumadocs/base-ui that the templates use:

npx npm-check-updates -u "fumadocs-*" "@fumadocs/*" && npm install

The Yarn command uses npm-check-updates, because yarn up replaces the alias with the Radix UI version of fumadocs-ui.

Major Versions

Read the release notes of a major version when you upgrade across it:

  • Fumadocs 16: removes the APIs deprecated since 15.2, moves the exports of fumadocs-core/server to specific modules, and requires React 19.2.
  • Fumadocs 15: migrates the styles to Tailwind CSS v4.
  • Fumadocs MDX 15: requires fumadocs-core 16.7.0 or later.
  • Fumadocs MDX 14: splits the generated .source folder into server, browser and dynamic entries.

How is this guide?

Last updated on