fumadocs-i18n

The fumadocs-i18n skill is a specialized automation tool designed to transform a standard Fumadocs project into a production-ready, multi-language documentation site. By aligning with official Fumadocs best practices, this skill handles the complex structural changes required to support global audiences, ensuring your content is accessible, SEO-friendly, and easy to maintain within the Next.js App Router environment.

This utility is intended for developers who need to add, scale, or restructure documentation into multiple languages such as English, Chinese, French, or Korean. It streamlines the manual overhead of updating routing logic, directory patterns, and UI components, allowing you to focus on content translation rather than infrastructure configuration.

• Automatically creates the lib/i18n.ts configuration to define supported locales and directory parsers.

• Configures middleware.ts to manage automatic locale redirection and path-based language detection.

• Restructures the app/ directory by moving routes into [lang] dynamic segments for clean URL structures like /en/docs/.

• Implements a functional language switcher component integrated directly into your existing navigation bar.

• Enforces strict content organization by configuring the content/docs/[lang] folder structure and updating source.ts to support per-language page trees.

• Enables sidebar filtering so that users only view documentation relevant to their current language context.

• Ensure your project already utilizes fumadocs-core, fumadocs-ui, and fumadocs-mdx before execution.

• The skill assumes a standard project layout with app/, content/, and lib/ directories; verify these paths if using a custom structure.

• Compatible with Next.js App Router patterns, leveraging server components and dynamic routing.

• Provides a built-in safety net for common pitfalls like sidebar leakage, broken routing, and parser configuration errors.

• The workflow is designed to be non-destructive, but it is recommended to run this in a clean git branch to easily review file changes.