Fumadocs

Quick Start

Getting Started with Fumadocs

Introduction

Fumadocs (Foo-ma docs) is a documentation framework based on Next.js, designed to be fast, flexible, and composes seamlessly into Next.js App Router.

Fumadocs has different parts:

Fumadocs Core

Handles most of the logic, including document search, content source adapters, and Markdown extensions.

Fumadocs UI

The default theme of Fumadocs offers a beautiful look for documentation sites and interactive components.

Content Source

The source of your content, can be a CMS or local data layers like Fumadocs MDX (the official content source).

Fumadocs CLI

A command line tool to install UI components and automate things, useful for customizing layouts.

Want to learn more?

Read our in-depth What is Fumadocs introduction.

Terminology

Markdown/MDX: Markdown is a markup language for creating formatted text. Fumadocs supports Markdown and MDX (superset of Markdown) out-of-the-box.

Although not required, some basic knowledge of Next.js App Router would be useful for further customisations.

Automatic Installation

A minimum version of Node.js 18 required, note that Node.js 23.1 might have problems with Next.js production build.

npm create fumadocs-app

It will ask you:

  • the React.js framework to use (the docs is only written for Next.js).
  • the content source to use.

A new fumadocs app should be initialized. Now you can start hacking!

From Existing Codebase?

You can follow the Manual Installation guide to get started.

Enjoy!

Create your first MDX file in the docs folder.

content/docs/index.mdx
---
title: Hello World
---

## Yo what's up

Run the app in development mode and see http://localhost:3000/docs.

npm run dev

FAQ

Some common questions you may encounter.

Upgrade Fumadocs

Make sure to upgrade Fumadocs when you've encountered any problems or trying out new features:

pnpm
pnpm update -i -r --latest

Learn More

New to here? Don't worry, we are welcome for your questions.

If you find anything confusing, please give your feedback on Github Discussion!

Writing Content

For authoring docs, make sure to read:

Special Needs

How is this guide?

Last updated on