Beautiful documentation that converts users

Product7 Websites12 Products2 flows6 sections

Websites 7

All websites
Pro4 more websites from MintlifyUnlock every screen, flow and Figma design with SaaSFrame Pro.See plans
Index of all 7 Mintlify websites examples

Products 12

All products
Pro9 more products from MintlifyUnlock every screen, flow and Figma design with SaaSFrame Pro.See plans
Index of all 12 Mintlify products examples

Flows 2

Mintlify User Onboarding

3 screens

SaaSFrame Pro

Unlock 1 more flow

Free accounts see one flow per SaaS. Pro unlocks every flow, screen and section, plus Copy in Figma.

Website sections 6

SaaSFrame Pro

Unlock 3 more Mintlify sections

Free accounts see three sections per page. Pro unlocks every section, screen and flow, plus Copy in Figma.

Design reference

Stack

Mintlify is a Next.js (App Router) application styled with Tailwind CSS. The marketing site (mintlify.com) and the documentation renderer share the same design language. Component logic is authored in React/TSX; icons are served from Font Awesome, Lucide, or Tabler depending on customer configuration. Code highlighting uses Shiki. The platform ships nine named layout themes (mint, maple, palm, willow, linden, almond, aspen, sequoia, luma), each of which varies spacing rhythm, sidebar style, and typographic weight while sharing a single underlying token system.

Typography

The default body font is Inter (Google Fonts). Each theme may substitute its own default — the Linden theme, for example, uses a monospace stack for a retro terminal aesthetic. Heading and body fonts are independently configurable via docs.json. The type scale observed across the marketing site and docs renderer follows Tailwind's fluid scale:

  • Display / hero: text-4xl (≈ 2.25 rem / 36 px), font-medium, tracking-tight
  • Section headings: text-2xl–text-3xl, font-semibold
  • Card titles / subheadings: text-base, font-medium
  • Body / prose: text-base (1 rem / 16 px), Tailwind prose prose-gray
  • Captions / eyebrow labels: text-sm (0.875 rem / 14 px), font-semibold, uppercase-style eyebrow utility
  • Small utility text: text-xs (0.75 rem / 12 px)

Line-height follows Tailwind defaults (1.5 for body, 1.25 tight for headings). Font weights in use: 400 (regular), 500 (medium), 600 (semibold). Variable-font weights (e.g. 550) are supported for custom font configurations.

Color Philosophy

Mintlify's color system is built around a single primary brand color that customers supply as a hex code. The platform generates a full tonal ramp from that seed and applies it to interactive elements (links, buttons, badges, focus rings). The platform's own default primary is #0D9373 (a vivid teal-green), with light-mode emphasis at full saturation and a lighter tint (#55D799) for dark-mode emphasis. Separate dark and light color overrides let customers tune button states independently. Gray is used structurally: gray-900/zinc-50 for headings, gray-500/zinc-500 for body copy, gray-200/gray-400 for muted labels. Dark mode inverts background and text using dark: Tailwind variants throughout; backgrounds shift from near-white to near-black (#0F172A slate-900 level). Both modes are supported simultaneously via a toggle; default mode follows the OS (appearance.default: "system").

Spacing

Spacing is entirely Tailwind-based. Common patterns observed:

  • Section vertical padding: py-16 (4 rem) on mobile, lg:py-48 (12 rem) on desktop
  • Card gaps: gap-x-6 (1.5 rem), gap-y-4 (1 rem)
  • Content max-width containers: max-w-3xl mx-auto for prose, max-w-xl for subtitles
  • Inline padding: px-4 (1 rem) default, lg:px-0 at large breakpoints
  • Component internal padding: pb-8 (2 rem) for card bottom, mt-4 / mt-5 for tight stacking
  • Background decoration offset: -top-14 (-3.5 rem) for SVG bleeds

Component Defaults

  • Cards: rounded corners (rounded-2xl = 1 rem radius), hover scale transform (group-hover:scale-105 transition-all duration-100), no visible border by default, image-led with title and description below
  • Buttons (primary): filled with colors.dark hex, hover states driven by the same token; border-radius follows theme default (typically rounded-lg = 0.5 rem)
  • Buttons (secondary/ghost): outlined or ghost style for secondary CTAs
  • Accordions: expand/collapse with URL hash sync; title + optional icon + optional description; defaultOpen boolean prop
  • Code blocks: Shiki-powered with theme configurable per mode; defaults to system (light/dark auto-switch)
  • Badges: small inline labels, color-coded (red for required, etc.)
  • Callouts/Notes: icon-prefixed alert blocks
  • Images: separate light/dark sources via className="block dark:hidden" / "hidden dark:block" pattern

Layout

The marketing site uses a full-width canvas with centered content columns. Documentation themes use a classic three-column layout (sidebar navigation / main content / right-side TOC), though this varies by theme — Sequoia and Willow prioritize content width at the expense of sidebars. The grid system is Tailwind's 12-column responsive grid, typically collapsing from sm:grid-cols-2 to single-column on mobile. The prose utility class governs all markdown-rendered content. Navigation is sticky top by default. Theme-specific layout choices include card-based nav (Almond), wide-canvas minimal (Sequoia), and sidebar-heavy complex navigation (Aspen).

Tech stack