
Mintlify
mintlify.comBeautiful documentation that converts users
Websites 7
All websitesIndex of all 7 Mintlify websites examples
Products 12
All productsFlows 2
Mintlify User Onboarding
3 screens
Website sections 6
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), Tailwindprose prose-gray - Captions / eyebrow labels:
text-sm(0.875 rem / 14 px),font-semibold, uppercase-styleeyebrowutility - 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-autofor prose,max-w-xlfor subtitles - Inline padding:
px-4(1 rem) default,lg:px-0at large breakpoints - Component internal padding:
pb-8(2 rem) for card bottom,mt-4/mt-5for 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.darkhex, hover states driven by the same token; border-radius follows theme default (typicallyrounded-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;
defaultOpenboolean 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).
















