Different ecosystems: Fumadocs for Next.js, Starlight for Astro. Fumadocs leads on downloads (309K vs 200K) and growth (3x vs 2x YoY). Starlight leads on zero-JS performance and multi-framework component support. Both are excellent — pick based on your stack.
Documentation
Docs-as-code frameworks, API documentation generators, documentation SaaS platforms, and documentation automation tools. The category splits into four overlapping lanes: OSS docs frameworks (Fumadocs #1, Starlight #2, Docusaurus #3), API docs (Fern #4, Redocly #6, Swagger UI #8), SaaS platforms (Mintlify #5, GitBook #10), and automation (Promptless #9). Fumadocs is the momentum winner — 3x YoY growth and 5-open-issues maintenance make it the clear pick for Next.js teams.
12
Ranked
6
Signals
Current ranking
Best for: Next.js teams wanting the fastest-growing, best-maintained docs framework with built-in OpenAPI rendering
11.2K stars, 309K npm/week, 3x YoY growth (fastest in category), 5 open issues (exceptional maintenance), built-in OpenAPI rendering + Orama search, actively releasing (fumapress@0.1.12, Mar 2026). Headless component architecture = full design ownership.
Best for: Content-first static docs with zero client-side JS — the DX leader for non-Next.js stacks
8.1K stars, 200K npm/week (doubled YoY), zero client-JS by default, Go-compiled dev server, 283 contributors. Real migration trend from Docusaurus (Distr, W3C). LogRocket independent comparison confirms performance advantages.
Best for: Large OSS projects needing versioned docs and a massive plugin ecosystem — the safe default
64.2K stars (largest in category), 765K npm/week, 457 contributors, maintained by Meta, built-in versioning, massive plugin ecosystem. The incumbent safe choice.
Best for: API-first companies that need both documentation AND production SDKs generated from a single OpenAPI spec
3.6K stars, 89K npm/week. Acquired by Postman (Jan 2026) — access to 500K+ companies. Customers: Square, Auth0, Adobe, Twilio, ElevenLabs. Only tool generating docs + SDKs (9 languages) from single spec. Daily pushes post-acquisition.
Best for: Teams wanting hosted developer docs with AI features and zero infra management — the premium SaaS choice
$21.7M funding (a16z). Acquired Helicone (Mar 2026) — pivoting to AI-agent knowledge infrastructure. 40%+ doc traffic from AI agents. Independent comparison (WriteChoice) confirms market-leader positioning.
Best for: Enterprise API documentation with compliance requirements, SOAP support, and strong OpenAPI linting
25.6K stars, 1.15M npm/week (highest raw downloads for API docs). Enterprise governance features, unique SOAP support, strongest OpenAPI linting.
Best for: Existing Python ecosystem docs — maintenance mode, migrate to Zensical when ready
26.3K stars, 4.2M PyPI/week (highest raw downloads of ANY docs tool). Now in maintenance mode. Zensical successor promises 4-5x faster builds. Major projects (Renovatebot, DDEV) already opening migration issues.
Best for: Simple, free OpenAPI spec rendering — the universal baseline
28.7K stars, 603K npm/week combined, actively maintained (v5.32.1, Mar 2026, weekly releases), OpenAPI 3.1.2 support. The universal baseline every API docs tool benchmarks against.
Best for: Teams where doc drift is the #1 pain — the only tool that auto-drafts doc updates from PRs/tickets/Slack
107pts Launch HN, YC W25. Named customers (Vellum 50%+ docs PRs, Vitess 94% doc updates, Amplitude). Unique 'doc drift' automation. Premium pricing ($500-1,000/mo).
Best for: Non-developer teams (PMs, support, marketing) needing WYSIWYG docs editing with AI Agent support
150K+ organizations (self-reported), built-in AI Agent (Intercom/Slack), WYSIWYG editor. Independent comparison confirms positioning for non-developer teams.
Best for: Self-hosted AI chatbot layer on top of existing documentation — complements docs generators
17.8K stars, 256pts Show HN (strongest HN reception in category). Self-hostable, multi-model, Kubernetes-ready. Different value prop: queries existing docs, doesn't generate them.
Best for: Existing Next.js docs sites — still works but no reason to choose over Fumadocs for new projects
13.7K stars, 113K npm/week. App Router support in v4. But growth is modest while Fumadocs grows 3x YoY and has overtaken in downloads (309K vs 113K).
Head to head
Both target Next.js. Fumadocs has overtaken Nextra on every momentum metric: 309K vs 113K npm/week, 3x YoY growth vs flat, better maintenance (5 vs 313 open issues). No reason to choose Nextra for new projects.
Docusaurus has the ecosystem (64K stars, plugins, versioned docs). Starlight has the DX (zero JS, fast dev server, Tailwind). Enterprise teams needing versioned docs → Docusaurus. New content-first sites → Starlight. Migration trend is real but not a stampede.
Different niches. Fern: docs + SDK generation (9 langs) from single spec, Postman-backed. Redocly: enterprise governance, SOAP support, OpenAPI linting. Fern for SDK-heavy API companies. Redocly for compliance-heavy enterprises.
Mintlify for developer-focused docs (MDX, AI writing, GitHub-native). GitBook for mixed teams with non-developer contributors (WYSIWYG, Intercom/Slack AI Agent). Mintlify is more technical; GitBook is more accessible.
Swagger UI is the free universal baseline for rendering OpenAPI specs. Fern adds SDK generation, authentication, environment switching — for API-first companies willing to invest. If you just need to render a spec, Swagger UI. If you need the full API docs + SDK pipeline, Fern.
Public signals
309K weekly downloads, 3x YoY growth. Now ahead of Starlight (200K) despite fewer stars. Fastest-growing docs framework.
Jan 7, 2026. Fern reaches Postman's 500K+ company user base. Most strategically significant move in API docs in 2026.
Mar 3, 2026. 40%+ of doc traffic from AI agents. Helicone processed 14.2T tokens across 16K orgs. Category-defining pivot.
4.2M PyPI/week framework in sunset. MkDocs upstream unmaintained since Aug 2024 — supply chain risk. Zensical promises 4-5x faster builds.
6/24 issues completed. Changes are maintenance-oriented, not a competitive response to Starlight/Fumadocs.
Compared to Fern (daily pushes) or Swagger UI (weekly releases), Redoc's cadence has slowed. 437 open issues.
What changes this
Docusaurus v4 ships with Starlight-competitive DX → jumps to #1 (ecosystem + performance would be unbeatable)
Starlight adds built-in versioned docs → jumps to #1 (removes its only critical gap)
Fumadocs growth stalls or single maintainer burns out → drops to #5+ (bus factor is the biggest risk)
Mintlify security incident recurs → drops to #8+ (trust is fragile for SaaS that touches code repos)
Promptless gets independent verification of customer metrics → jumps to #6-7
Zensical reaches feature parity with MkDocs Material → enters ranking at #4-5 for Python ecosystem teams
Fern+Postman integration deepens → could jump to #2-3 if distribution converts API teams
Context7 or llms.txt becomes a standard → tools with native support gain an edge (currently no framework has this built-in)