Mintlify — decoded design system

mintlify.com · light · modern · tailwind · deep decode — measured live

Mintlify's design system, decoded live by Mozaika: measured color roles, type scale, buttons with real hover/focus states, motion and the brand's own tokens.

Open in Mozaika →

This is a static, crawlable rendering for search & AI engines. The interactive version — filters, live decode console, copy & export — is at https://mozaika.design/decode/mintlify.com.

Decoded design system

Mintlify's decoded design system: background #FFFFFF, text #000000, accent #EF6333, link #EF6333, primary #FF7A59; type scale h1 50px / h2 44px / body 14px; 8px spacing base; 4px base radius. The single interactive/action color is #FEFDFB — used only on interactive or must-notice elements (buttons, links, key highlights), never on large fills.

Color roles

Using these colors

• Action color #FEFDFB — the single interactive color; only on things you click or must notice, never large fills.
• accent, link are all #EF6333 — one role, not several (the action color).
• accent #EF6333 — accent for emphasis — keep it rare on the page.
• primary #FF7A59 — a brand color — but the call-to-action uses #FEFDFB, not this.
• secondary #00A8E0 — optional secondary accent — LOW decode confidence; use rarely (a status color or a single decorative moment) or omit it entirely. Prefer one accent unless the reference clearly shows two.

Typography

• Heading: Arizona Flare
• Body: Inter
• h1: 50px
• h2: 44px
• body: 14px

Spacing

• base unit: 8px
• scale: 4px, 6px, 8px, 10px, 12px, 16px, 20px, 24px, 32px, 40px

Radii

• base: 4px
• button: 4px

Motion

Micro-interactions run at 150ms (dominant) with cubic-bezier(0.4, 0, 0.2, 1).

• durations: 150ms · 100ms · 500ms
• easings: cubic-bezier(0.4, 0, 0.2, 1) · cubic-bezier(0, 0, 0.2, 1)
• animated properties: opacity, background-color, color, border-color

Native design tokens

…and 110 more measured on the page.

Button states (measured)

• primary hover: background #FAF8F5
• primary focus: box-shadow rgb(12, 140, 94) 0px 0px 0px 2px · outline 2px solid lab(51.3415 -41.5657 15.3527)

Layout (measured)

• container max-width: 1088px
• nav: 65px sticky
• common grid: 24 columns

Motion choreography (measured)

Load order: div.flex → span.animate-signal-ping → span.animate-signal-flicker → a.group×4 → div.c15t-ui-root-hE9Kz → div.c15t-ui-root-hE9Kz

Scroll reveal: 12 elements rest at opacity 0, animate in over 0.15s cubic-bezier(0, 0, 0.2, 1).

Overlay recipe (measured)

dialog panel: #FEFDFB · radius 12px

Responsive (measured)

• breakpoints: 640px
• mobile (390px): hero 40px · nav hamburger

Install it

Drop this measured system into any shadcn/Tailwind project in one command:

npx shadcn add mozaika.design/r/decode/mintlify.com

registry item · or query it over MCP: get_design_system("Mintlify")

Export: DESIGN.md

# Mintlify — Design System

> light, modern, medium, tailwind — deep decode (measured live)

## Colors

| Role | Value |
|------|-------|
| bg | `#FFFFFF` |
| surface | `#EFEFEF` |
| border | `#D8D8D8` |
| text | `#000000` |
| text_muted | `#606060` |
| primary | `#FF7A59` |
| accent | `#EF6333` |
| link | `#EF6333` |
| secondary | `#00A8E0` |
| button_bg | `#FEFDFB` |
| button_text | `#121715` |

**Using these colors**

- **Action color** `#FEFDFB` — the single interactive color; it appears only on things you click or must notice (buttons, key highlights), never on large fills or backgrounds.
- `accent`, `link` are all `#EF6333` — one role, not several.
- **accent** `#EF6333` — accent for emphasis — keep it rare on the page.
- **primary** `#FF7A59` — a brand color — but the call-to-action uses #FEFDFB, not this.
- **secondary** `#00A8E0` — optional secondary accent — LOW decode confidence; use rarely (a status color or a single decorative moment) or omit it entirely. Prefer one accent unless the reference clearly shows two.
- **Page coverage** (full-page screenshot pixels): `#FFFFFF` 83.4% · `#ECF6F2` 12.3% · `#A8AEAC` 4.4%

## Typography

- Heading: **Arizona Flare** _(free fallback: Newsreader)_
- Body: **Inter**

| Role | Size / weight · line-height · tracking |
|------|------------------------------------------|
| hero | 50px / 400 · lh 52px · tracking -2px |
| h2 | 44px / 400 · lh 48px · tracking -0.88px |
| h3 | 36px / 500 · lh 40px · tracking -0.72px |
| body | 14px / 500 · lh 16px |
| small | 12px / 500 · lh 16px · tracking 0.24px |

- Weight ladder: 400 · 500 — use these exact measured weights, not the 400/600 defaults.

> **Fonts —** Arizona Flare may be proprietary — safe free fallback: Newsreader (Google Fonts). Inter — free, on Google.

## Spacing
- base unit: 8px (inferred from the measured scale)
- measured scale: 4px, 6px, 8px, 10px, 12px, 16px, 20px, 24px, 32px, 40px — snap all gaps/padding to these

## Radius
- base: 4px
- button: 4px
- card: 4px
- sharp: 2px

## Buttons

| Button | Fill / text | Border | Radius | Padding | Font | Shadow |
|--------|-------------|--------|--------|---------|------|--------|
| primary | `#FEFDFB` / `#121715` | 1px solid oklab(0 0 0 / 0.05) | 4px | 12px 16px 12px 16px | 500 14px | none |
| secondary | `lab(2.42579 -0.165291 -0.470081)` / `lab(100 0 0)` | 1px solid rgba(0, 0, 0, 0) | 4px | 12px 12px 12px 16px | 500 14px | none |

**States (measured, not guessed)**

- primary hover: background `#FAF8F5`
- primary focus: box-shadow `rgb(12, 140, 94) 0px 0px 0px 2px` · outline `2px solid lab(51.3415 -41.5657 15.3527)`
- secondary hover: background `oklab(0.139 -0.00116885 -0.00265123 / 0.9)`
- transition: `color 0.1s cubic-bezier(0.4, 0, 0.2, 1)`

## Motion
- durations: 150ms (dominant) · 100ms · 500ms
- easings: `cubic-bezier(0.4, 0, 0.2, 1)` (dominant) · `cubic-bezier(0, 0, 0.2, 1)`
- animated properties: opacity, background-color, color, border-color

Micro-interactions use the dominant duration + easing; nothing on the page animates slower than the longest duration above — don't invent springier motion.

## Their own tokens (verbatim from :root)

| Token | Value |
|-------|-------|
| `--twoslash-border-color` | `#dbdfde` |
| `--twoslash-popup-bg` | `#f3f7f6` |
| `--twoslash-popup-shadow` | `rgba(0,0,0,.08) 0px 1px 4px` |
| `--twoslash-highlighted-border` | `rgba(195,125,13,.314)` |
| `--twoslash-highlighted-bg` | `rgba(195,125,13,.125)` |
| `--twoslash-unmatched-color` | `#888` |
| `--twoslash-cursor-color` | `rgba(136,136,136,.533)` |
| `--twoslash-error-color` | `#d45656` |
| `--twoslash-error-bg` | `rgba(212,86,86,.125)` |
| `--twoslash-warn-color` | `#c37d0d` |
| `--twoslash-warn-bg` | `rgba(195,125,13,.125)` |
| `--twoslash-tag-color` | `#3772cf` |

_…and 108 more measured on the page._

Prefer these names when extending their system — it's the brand's actual vocabulary.

## Layout (measured)
- container max 1088px · common grid: 24-col
- nav: 65px sticky · border-bottom 1px solid rgb(241, 240, 238) · bg lab(100 0 0)

| Section (y) | Height | Cols | Gap | Pad y | Split |
|---|---|---|---|---|---|
| 65 | 992 | 24 | 16 | 0/0 | — |
| 1057 | 608 | 24 | 16 | 0/0 | — |
| 1665 | 1660 | 24 | 16 | 0/0 | — |
| 3325 | 864 | 24 | 16 | 0/0 | — |
| 4189 | 853 | 24 | 16 | 0/0 | — |

## Motion choreography (measured)
Load order: `div.flex` @0ms → `span.animate-signal-ping` @0ms → `span.animate-signal-flicker` @0ms → `a.group`×4 @434ms → `div.c15t-ui-root-hE9Kz` @500ms → `div.c15t-ui-root-hE9Kz` @500ms
- `span.flex` — transform translateY(-24px)→translateY(-36px) — 700ms cubic-bezier(0.22, 1, 0.36, 1)
- `span.animate-signal-ping` — opacity 0.65→0 · transform scale(1)→scale(3.2) — 1050ms cubic-bezier(0, 0, 0.2, 1) · loops
- `span.animate-signal-flicker` — opacity 1→0.35 — 1050ms ease-in-out · loops
- scroll reveal: 12 elements rest at opacity 0, animate in over 0.15s cubic-bezier(0, 0, 0.2, 1) (0 revealed during the drive).
- overlay dialog (auto-opened): panel #FEFDFB · r 12px · shadow 

Rebuild the timeline, not just the durations — order, delays and staggers above are the choreography.

## Components (measured)
- link: lab(100 0 0) · no underline
- disabled: bg #FEFDFB · text #121715

## Responsive (measured)
- breakpoints: 640px
- mobile (390px): hero 40px · body 16px · nav: hamburger

## How to apply
Paste the Tailwind `@theme` (or CSS variables) as your base, then build each
section to its spec — verify every color, radius, and font against these tokens.
Hover/focus states, shadows and motion timings above are measured from the live page — match them exactly, don't re-guess them.

An automated reading of Mintlify's publicly-visible CSS (colors, fonts, spacing, motion) — not affiliated with mintlify.com. No screenshots stored. Removal requests: hello@mozaika.design.