Sections and navigation

Use short, descriptive section titles. Put the quickstart before detailed reference material and keep related tasks together.

In a new Fumadocs project, section folders use meta.json to set their title and page order. Add an index.mdx when the section needs a landing page. See sidebar configuration.

Icons are optional. If you customize them, use icons supported by the installed template and keep their meaning consistent. New Fumadocs layouts use Lucide components rather than the older template's Phosphor CSS classes.

Review the navigation on mobile as well as desktop. A clear title is more useful than decorative complexity.