> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcertio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentation platform comparison

# Documentation Platform Strategy: The "Premium" Choice

**Status**: Recommended
**Date**: 2026-01-27
**Recommendation**: **Fumadocs** (Self-Hosted Next.js)

## 1. Executive Summary

You asked about **Mintlify**. While Mintlify is excellent for quick setup, it has two fatal flaws for Certio:

1. **Forced Branding**: The Free tier forces a "Powered by Mintlify" badge. Removing it costs **\$250/month**.
2. **Siloed**: It lives outside your Next.js Monorepo, making it harder to share components (like your Pricing Table or Login buttons) with your docs.

**The Winner: Fumadocs**.
It is the bleeding-edge standard for Next.js documentation. It is fast, fully customizable (Tailwind), supports MDX, and fits perfectly into `apps/docs` in your existing monorepo.

## 2. Comparison Matrix

| Feature             | Mintlify (SaaS)                                  | Fumadocs (Next.js Framework)                 | Docusaurus                      |
| :------------------ | :----------------------------------------------- | :------------------------------------------- | :------------------------------ |
| **Cost**            | **$0/mo** (Branded) or **$250/mo** (White Label) | **\$0/mo** (White Label)                     | \$0/mo                          |
| **Hosting**         | Managed                                          | Vercel (Already paying)                      | Vercel / Netlify                |
| **Monorepo Fit**    | ❌ None (External Repo)                           | ✅ **Perfect** (`apps/docs`)                  | ⚠️ Clunky (Separate Build)      |
| **Git Sync**        | ✅ **Automated** (via GitHub App)                 | ✅ **Automated** (via Vercel/CI)              | ✅ **Automated** (via Vercel/CI) |
| **Component Reuse** | ❌ **Hard** (Cannot import `@certio/ui`)          | ✅ **Native** (Import directly from Monorepo) | ⚠️ **Hard** (Separate Build)    |
| **Custom UI**       | Limited (Config only)                            | Unlimited (It's just React)                  | Moderate (Swizzling)            |
| **Vibe**            | "Startup Generic"                                | "Vercel / Stripe Premium"                    | "Open Source Generic"           |

## 3. Why Fumadocs?

* **Monorepo Native**: It lives in `apps/docs`. You can run `npm run dev` and see your Dashboard and Docs side-by-side.
* **Shared UI**: You can import your `@certio/ui` components (Buttons, Badges) directly into your documentation.
* **Type-Safe**: It uses content collections for robust MDX handling.
* **Clean URLs**: `docs.getcertio.com` via Vercel Rewrites or a separate project, all managed in the same repo.

## 4. Implementation Plan (Phase 6)

1. **Scaffold**: Initialize `apps/docs` using the Fumadocs template.
2. **Configure**: Set up `docs.getcertio.com` domain.
3. **Content**: Migrate any existing notes to MDX.
4. **Deploy**: Push to Vercel as a new Project linked to the same Repo.

## 5. Verdict

**Save the \$250/month.** Use Fumadocs. It looks better, flows better with your stack, and you own it completely.