# Mintlify

> Beautiful documentation that converts users

Mintlify UI and UX design examples on SaaSFrame: 19 screens, 2 user flows, 6 website sections.

- URL: https://www.saasframe.io/saas/mintlify
- Website: https://mintlify.com/
- Industry: [Product](https://www.saasframe.io/industries/product)
- Websites: 7 screens
- Products: 12 screens
- Built with: [Vercel](https://www.saasframe.io/stack/vercel)

## Websites (7)

- [Landing Page](https://www.saasframe.io/examples/mintlify-landing-page-e868a)
- [Landing Page](https://www.saasframe.io/examples/mintlify-landing-page)
- [Customers Page](https://www.saasframe.io/examples/mintlify-customers-page)
- All 7 websites from Mintlify: https://www.saasframe.io/search-screens?brand=276&format=marketing

## Products (12)

- [Signup Page](https://www.saasframe.io/examples/mintlify-signup-page)
- [Verification](https://www.saasframe.io/examples/mintlify-verification)
- [Login to Github](https://www.saasframe.io/examples/mintlify-login-to-github)
- All 12 products from Mintlify: https://www.saasframe.io/search-screens?brand=276&format=product

## User flows (2)

- [User Onboarding](https://www.saasframe.io/flows/mintlify-user-onboarding): 3 steps
- 1 more flow with SaaSFrame Pro: https://www.saasframe.io/pricing

## 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).

Source: [SaaSFrame](https://www.saasframe.io/saas/mintlify)
