Fumadocs

Was ist Fumadocs?

Fumadocs ist ein React-basiertes Framework zum Erstellen von Dokumentationswebsites. Es setzt auf MDX als Inhaltsformat und läuft primär mit Next.js, unterstützt aber auch React Router und Waku. Wer eine Dokumentation aufbauen will, die über statische Seiten hinausgeht und echte React-Komponenten einbettet, findet hier eine durchdachte Grundlage. Das Projekt ist Open Source und wird aktiv weiterentwickelt.

Kernfunktionen

• MDX mit Entwickler-Extras: Fumadocs unterstützt TypeScript Twoslash direkt in Codeblöcken sowie Shiki für Syntax-Highlighting. Typen und Fehler lassen sich so inline in der Dokumentation zeigen.
• OpenAPI-Integration: API-Dokumentationen lassen sich aus OpenAPI-Spezifikationen automatisch generieren, ohne jede Route manuell zu pflegen.
• Headless Mode und Theme-CLI: Wer das Standard-Layout nicht übernehmen will, kann Fumadocs ohne vorgegebene Styles verwenden und das Theme über die CLI anpassen.
• CMS-Kompatibilität: Es gibt offizielle Integrationen für Sanity, Payload und Content Collections, sodass Inhalte auch aus externen Quellen stammen können.
• React Server Components: Fumadocs nutzt die Next.js-App-Router-Architektur und unterstützt Server Components, was die Möglichkeiten beim Rendering erweitert.

Für wen eignet sich Fumadocs?

Die Zielgruppe sind Entwickler und Engineering-Teams, die Dokumentationen für Open-Source-Bibliotheken, UI-Komponenten oder SaaS-Produkte bauen. Wer bereits mit Next.js arbeitet, kann Fumadocs direkt integrieren.

Die Hürde ist klar: Ohne React-Kenntnisse kommt man nicht weit. Das Framework setzt voraus, dass man versteht, wie Komponenten funktionieren, wie MDX-Dateien aufgebaut sind und wie Next.js Routen verwaltet. Für Redakteure oder Produktmanager ohne JavaScript-Hintergrund ist es ohne Entwickler-Support nicht nutzbar.

Außerhalb des JavaScript-Ökosystems gibt es keine Unterstützung. Wer eine Django- oder Rails-Applikation dokumentiert, muss die Inhalte trotzdem in einem JavaScript-Projekt verwalten.

Einordnung & Alternativen

Fumadocs bewegt sich im gleichen Segment wie Docusaurus und Nextra. Beide sind ebenfalls React-basiert, Docusaurus jedoch weniger auf Next.js fokussiert und stärker auf vorgefertigte Strukturen ausgelegt. Nextra ist konzeptuell ähnlich zu Fumadocs, bietet aber weniger Flexibilität beim Theming und keine vergleichbare OpenAPI-Integration.

Wer statt eines React-Stacks lieber reines Markdown mit minimalem Build-Setup bevorzugt, ist mit VitePress oder MkDocs besser bedient. Der konkrete Vorteil von Fumadocs liegt im Headless-Ansatz: Das Framework liefert Logik und Datenstruktur, das visuelle Ergebnis lässt sich vollständig selbst gestalten.