Internationalization

import { i18n } from '@/lib/i18n';
import { loader } from 'fumadocs-core/source';

export const source = loader({
  i18n, 
  // other options
});

And update Fumadocs UI layout options.

Middleware

Create a middleware that redirects users to appropriate locale.

See Middleware for customisable options.

Routing

Create a /app/[lang] folder, and move all files (e.g. page.tsx, layout.tsx) from /app to the folder.

Wrap the root provider inside I18nProvider, and provide available languages & translations to it. Note that only English translations are provided by default.

Pass Locale

Pass the locale to Fumadocs in your pages and layouts.

Search

Configure i18n on your search solution.

• Built-in Search (Orama): For Supported Languages, no further changes are needed.

  Otherwise, additional config is required (e.g. Chinese & Japanese). See Special Languages.

• Cloud Solutions (e.g. Algolia): They usually have official support for multilingual.

Writing Documents

Navigation

Fumadocs only handles navigation for its own layouts (e.g. sidebar). For other places, you can use the useParams hook to get the locale from url, and attend it to href.

In addition, the fumadocs-core/dynamic-link component supports dynamic hrefs, you can use it to attend the locale prefix. It is useful for Markdown/MDX content.