skills.rest
compozy
compozyOFFICIAL
Explore all skills by this author →
Website𝕏@compozyaiGitHub

fumadocs

Configure and troubleshoot Fumadocs documentation sites across React framework adapters.

182|8|Updated Apr 4, 2026
Search Tags:#next.js#fumadocs#react router#documentation framework#mdx pipeline#search and i18n#adapter wiring
One-click install
npx skills add https://github.com/compozy/agh --skill fumadocs-compozy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fumadocs
Source: https://github.com/compozy/agh/tree/main/.agents/skills/fumadocs
Command: npx skills add https://github.com/compozy/agh --skill fumadocs-compozy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Fumadocs projects fail to scaffold, route, index, and render documentation correctly when the adapter, loader configuration, UI layout wiring, or MDX pipeline details are inconsistent, leading to broken sidebars, missing search, stale content, or build-time errors.

Core Features & Use Cases

  • Fumadocs framework guidance: Choose the correct Fumadocs stack components (fumadocs-core, fumadocs-mdx, fumadocs-ui) and configure them for your React framework adapter.
  • Deterministic setup and wiring: Map user intent to the right task class (setup, routing/page tree, MDX pipeline, UI layouts/components, search/i18n, integrations, debugging).
  • Practical operational procedures: Validate configuration conflicts, regenerate .source outputs, and debug common failure modes such as Tailwind version mismatch and provider import path issues.
  • Use case: When you need to migrate an existing docs app to Fumadocs or fix a broken sidebar/search UI after changing loader or layouts, follow the skill’s staged checklist and reference pitfall catalog to restore correctness quickly.

Quick Start

Use the fumadocs skill to diagnose why your docs sidebar is blank and your search dialog does not return results after configuring the loader and layouts.

Frequently Asked Questions about fumadocs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a blank sidebar and missing search results in a Fumadocs documentation site?▼

To fix a blank sidebar and missing search in Fumadocs, validate that your framework adapter matches your loader configuration and UI layouts, then regenerate the .source directory outputs to rebuild the page tree and search index correctly.

Can I use Fumadocs with React Router or TanStack Start instead of Next.js?▼

Fumadocs supports React Router, TanStack Start, and Waku adapters alongside Next.js. Wiring the correct framework adapter ensures deterministic routing conventions, page-tree selection, and layout provider matching without silent misconfiguration.

What is the best way to configure the MDX pipeline and content sources in Fumadocs?▼

Configuring the MDX pipeline in Fumadocs requires mapping content sources to the correct MDX entry modes and validating configuration conflicts. Regenerating .source outputs and running typechecks ensures deterministic setup and prevents stale content or build-time errors.

Why does my Fumadocs build fail after updating Tailwind or changing provider import paths?▼

Fumadocs builds commonly fail due to Tailwind v3 version mismatch or provider subpath import path issues. Checking the pitfall catalog for layout and page import mismatches helps diagnose and resolve these silent configuration errors quickly.

How do I enable internationalization and search in a Fumadocs documentation framework?▼

To enable i18n and search in Fumadocs, wire the search index and configure internationalization loaders according to your framework adapter. Validating configuration conflicts ensures the search dialog returns results and localized content renders without build errors.

Does Fumadocs support OpenAPI integrations and external content sources?▼

Yes, Fumadocs supports integration scenarios including OpenAPI and external content sources. Correctly wiring these integrations into your loader and MDX pipeline ensures reliable documentation rendering and prevents silent misconfiguration across your React framework adapter.

Related Skills

Explore More Software Engineering Skills→
greyhaven-aigreyhaven-ai
29

grey-haven-tanstack-patterns

Standardize TanStack Start, Router, and Query patterns in React 19 applications.

Community
Intermediate
yoanbernabeuyoanbernabeu
34

slidev-deployment

Deploy Slidev presentations to GitHub Pages, Netlify, Vercel, or Docker.

Community
Advanced
TheOrcDevTheOrcDev
2.0k

fumadocs-mdx-structure

Create structured MDX documentation files for 8-bit components with standardized frontmatter and imports.

Community
Basic
seo-jinseokseo-jinseok

moai-library-nextra

Create and manage documentation websites with Nextra and Next.js.

Community
Advanced