What is Fumadocs

Fumadocs was created because I wanted a more customisable experience for building docs, to be a docs framework that is not opinionated, a "framework" that you can break.

Philosophy

Less Abstraction: Fumadocs expects you to write code and cooperate with the rest of your software. While most frameworks are configured with a configuration file, they usually lack flexibility when you hope to tune its details. You can’t control how they render the page nor the internal logic. Fumadocs shows you how the app works, instead of a single configuration file.

Next.js Fundamentals: It gives you the utilities and a good-looking UI. You are still using features of Next.js App Router, like Static Site Generation. There is nothing new for Next.js developers, so you can use it with confidence.

Opinionated on UI: The only thing Fumadocs UI (the default theme) offers is User Interface. The UI is opinionated for bringing better mobile responsiveness and user experience. Instead, we use a much more flexible approach inspired by Shadcn UI — Fumadocs CLI, so we can iterate our design quick, and welcome for more feedback about the UI.

Why Fumadocs

Fumadocs is designed with flexibility in mind.

You can use fumadocs-core as a headless UI library and bring your own styles. Fumadocs MDX is also a useful library to handle MDX content in Next.js. It also includes:

• Many built-in components.
• Typescript Twoslash, OpenAPI, and Math (KaTeX) integrations.
• Fast and optimized by default, natively built on App Router.
• Tight integration with Next.js, you can add it to an existing Next.js project easily.

You can read Comparisons if you're interested.