open-design/design-systems/cursor/components.html
chaoxiaoche e62b87b62c
feat(design-systems): add structured tokens for cursor, apple, stripe, airbnb, vercel brands (#1652)
* feat(design-systems): add structured tokens for cursor brand

Introduces design-systems/cursor/tokens.css + components.html, the
third structured brand after default and kami. Brings the prose
DESIGN.md into the schema-checked form so agents picking the cursor
design system get the structured token channel (PR-D #1544) instead
of having to re-derive Cursor's warm-cream palette, three-voice
typography (CursorGothic / jjannon / berkeleyMono), oklab borders,
and depth-based focus from prose every turn.

Why now: PR-D made the structured channel default-on, but it only
materially helps the 2 brands shipping tokens.css today. To expand
batch-design-system-test (#1515) coverage beyond default + kami,
we are hand-authoring 5 high-profile brands (cursor first as
template, then apple / stripe / airbnb / vercel) before the bulk
derive script (PR-B). These five also serve as the byte-identical
oracle the future derive script must reproduce.

Brand-specific schema decisions, captured in the tokens.css header:
- Surface: 3-tier cream ladder (#f2f1ed → #ebeae5 → #e6e5e0).
  --surface-warm binds to a real intermediate tier, not aliased.
- Foreground: 4-tier ramp via rgba(38,37,30,a) at 1.0 / 0.9 / 0.55
  / 0.4 — Cursor genuinely has the richer ramp.
- Borders: oklab origins shipped as rgba fallbacks per DESIGN.md
  §Agent Prompt Guide rule 3.
- --tracking-display: -0.03em (the 72px hero value normalized to
  em). Smaller display sizes scale tracking proportionally inline.
- --elev-raised: signature 28/70px diffused atmospheric shadow.
- --focus-ring: depth-only (0 4px 12px), never the cool-blue halo.
- --ease-standard: ease (per DESIGN.md), not the schema cubic-bezier.
- --danger: warm crimson #cf2d56, used for the brand-signature
  hover-text-shift on buttons.

components.html demonstrates the full surface (hero with 72px
CursorGothic + jjannon serif lead, three-voice typography, warm-
surface CTA with crimson hover, accent-orange pill CTA used once,
oklab-fallback bordered cards, AI timeline signature element with
the warm pastel state colors, jjannon-serif input with 4-12 depth
focus). :root paste is byte-identical to tokens.css.

Verified:
- pnpm guard — 13/13 checks pass, including all 8 design-system
  sub-checks now reporting "3 brands" (default + kami + cursor):
  - token-fixture sync: 3 brand pairs aligned
  - A1/A2/B-slot required tokens: all 3 brands declare
    26 A1 + 26 A2 + 4 B-slot
  - unknown token allowlist: 185 declarations across 3 brands all
    match shared schema or brand extensions
  - flag parity: 146 prose-only brands byte-identical, 3 structured
    diverge as expected

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(design-systems): correct h2/h3 line-height in cursor components fixture

Per DESIGN.md §Hierarchy, 36px section headings use line-height 1.20
and 26px sub-headings use 1.25. The shared h1/h2/h3 rule was locking
all three to --leading-tight (1.10), baking wrong vertical rhythm into
the oracle fixture.

Co-authored-by: Cursor <cursoragent@cursor.com>

* feat(design-systems): add structured tokens for apple, stripe, airbnb, vercel brands

Batch follow-up to #1652 (cursor). Adds tokens.css + components.html
for the remaining four high-profile brands, using cursor as the
format/template oracle.

Each brand encodes its specific identity:
- apple: SF Pro tight-compressed display (--leading-tight 1.05),
  system-blue accent, SF Symbols grid, frosted glass surfaces
- stripe: sohne-var weight-300 anti-convention signature, --leading-tight
  1.10 (matches all heading spec values exactly), indigo accent
- airbnb: Cereal weight-700 display with Rausch coral, --leading-tight
  1.20 with per-size overrides (h2→1.18, h3→1.25)
- vercel: Geist 600 compressed display, --leading-tight 1.10 with
  per-size overrides (h2→1.20, h3→1.33 per DESIGN.md §Typography)

pnpm guard: 13/13 checks pass; flag-parity now shows 6 structured
brands and 143 prose-only brands.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: chaoxiaoche <chaoxiaoche@chaoxiaochedeMacBook-Pro.local>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-15 16:53:51 +08:00

654 lines
25 KiB
HTML

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Cursor — reference components</title>
<meta
name="description"
content="Reference fixture for design-systems/cursor. Every visible
value comes from tokens.css; if the agent paste-replaces the
:root block and reuses the component selectors below verbatim,
the artifact passes lint without further audit. Cursor's
signature moves: warm cream surfaces, three typographic voices
(CursorGothic / jjannon / berkeleyMono), oklab borders rendered
as rgba fallback, hover-text shifts to --danger crimson, and
diffused atmospheric shadows."
/>
<style>
/* :root paste — sourced verbatim from
design-systems/cursor/tokens.css. Keep this block in sync
when tokens.css changes. The agent prompt instructs the
Designer panelist to paste this block as the FIRST thing in
their <style>, then reference everything below via var(...). */
:root {
--bg: #f2f1ed;
--surface: #e6e5e0;
--surface-warm: #ebeae5;
--fg: #26251e;
--fg-2: rgba(38, 37, 30, 0.9);
--muted: rgba(38, 37, 30, 0.55);
--meta: rgba(38, 37, 30, 0.4);
--border: rgba(38, 37, 30, 0.1);
--border-soft: rgba(38, 37, 30, 0.06);
--accent: #f54e00;
--accent-on: #ffffff;
--accent-hover: color-mix(in oklab, var(--accent), black 8%);
--accent-active: color-mix(in oklab, var(--accent), black 14%);
--success: #1f8a65;
--warn: #eab308;
--danger: #cf2d56;
--font-display: "CursorGothic", "CursorGothic Fallback", system-ui, "Helvetica Neue", Helvetica, Arial, sans-serif;
--font-body: "jjannon", "Iowan Old Style", "Palatino Linotype", "URW Palladio L", P052, ui-serif, Georgia, Cambria, "Times New Roman", Times, serif;
--font-mono: "berkeleyMono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
--text-xs: 11px;
--text-sm: 14px;
--text-base: 16px;
--text-lg: 19.2px;
--text-xl: 22px;
--text-2xl: 26px;
--text-3xl: 36px;
--text-4xl: 72px;
--leading-body: 1.5;
--leading-tight: 1.10;
--tracking-display: -0.03em;
--space-1: 4px;
--space-2: 8px;
--space-3: 12px;
--space-4: 16px;
--space-5: 20px;
--space-6: 24px;
--space-8: 32px;
--space-12: 48px;
--section-y-desktop: 80px;
--section-y-tablet: 48px;
--section-y-phone: 32px;
--radius-sm: 8px;
--radius-md: 10px;
--radius-lg: 12px;
--radius-pill: 9999px;
--elev-flat: none;
--elev-ring: 0 0 0 1px var(--border);
--elev-raised:
0 28px 70px rgba(0, 0, 0, 0.14),
0 14px 32px rgba(0, 0, 0, 0.1),
0 0 0 1px var(--border);
--focus-ring: 0 4px 12px rgba(0, 0, 0, 0.1);
--motion-fast: 150ms;
--motion-base: 200ms;
--ease-standard: ease;
--container-max: 1200px;
--container-gutter-desktop: 24px;
--container-gutter-tablet: 16px;
--container-gutter-phone: 12px;
}
/* ─── Reset (minimal) ───────────────────────────────────── */
*, *::before, *::after { box-sizing: border-box; }
html, body { margin: 0; padding: 0; }
body {
background: var(--bg);
color: var(--fg);
/* Body uses jjannon serif. The three-voice system is a brand
signature; do not collapse to one font for "simplicity". */
font-family: var(--font-body);
font-size: var(--text-base);
line-height: var(--leading-body);
font-feature-settings: "cswh"; /* contextual swash alternates */
-webkit-font-smoothing: antialiased;
}
/* ─── Layout primitives ─────────────────────────────────── */
.container {
max-width: var(--container-max);
margin-inline: auto;
padding-inline: var(--container-gutter-desktop);
}
section { padding-block: var(--section-y-desktop); }
section + section {
/* Cursor's section separation is via tone shift + spacing,
not hard rules. The ring is intentionally faint. */
border-top: 1px solid var(--border);
}
@media (max-width: 1023px) {
.container { padding-inline: var(--container-gutter-tablet); }
section { padding-block: var(--section-y-tablet); }
}
@media (max-width: 639px) {
.container { padding-inline: var(--container-gutter-phone); }
section { padding-block: var(--section-y-phone); }
}
/* ─── Typography ────────────────────────────────────────── */
h1, h2, h3 {
font-family: var(--font-display);
line-height: var(--leading-tight);
margin: 0;
/* CursorGothic uses weight 400 almost exclusively; size +
tracking carry hierarchy, not weight (DESIGN.md §3.4). */
font-weight: 400;
}
h1 {
/* Hero uses --text-4xl=72px with the full -0.03em tracking. */
font-size: var(--text-4xl);
letter-spacing: var(--tracking-display);
}
h2 {
font-size: var(--text-3xl);
/* 36px section heading: line-height 1.20, tracking -0.72px (-0.02em).
Overrides the shared 1.10 (--leading-tight) set on h1/h2/h3 above. */
line-height: 1.20;
letter-spacing: -0.02em;
}
h3 {
font-size: var(--text-2xl);
/* 26px sub-heading: line-height 1.25, tracking -0.325px (-0.0125em).
Overrides the shared 1.10 (--leading-tight) set on h1/h2/h3 above. */
line-height: 1.25;
letter-spacing: -0.0125em;
}
p { margin: 0; }
.lead {
/* Lead body in serif voice — Cursor's editorial signature. */
font-family: var(--font-body);
font-size: var(--text-lg);
line-height: 1.35;
color: var(--muted);
}
.body-muted { color: var(--muted); }
.body-sm { font-size: var(--text-sm); }
.body-mono { font-family: var(--font-mono); font-size: var(--text-sm); }
/* `.eyebrow` — uppercase micro label, system-ui voice. Letter
spacing is well above craft/typography.md's 0.06em floor. */
.eyebrow {
font-family: var(--font-display);
font-size: var(--text-xs);
color: var(--muted);
text-transform: uppercase;
letter-spacing: 0.08em;
font-weight: 500;
}
.stack-3 > * + * { margin-block-start: var(--space-3); }
.stack-4 > * + * { margin-block-start: var(--space-4); }
.stack-6 > * + * { margin-block-start: var(--space-6); }
/* ─── Buttons ───────────────────────────────────────────── */
/* Cursor's primary CTA is NOT accent-bg — it is warm-surface bg
with dark text, signature for the brand. The accent orange
appears on link decoration and on the "accent pill" CTA used
sparingly (≤1 per screen). The hover signature is a text-color
shift to --danger (warm crimson), not bg-darken. */
.btn {
display: inline-flex;
align-items: center;
gap: var(--space-2);
padding: 10px 14px;
border-radius: var(--radius-sm);
font-family: var(--font-display);
font-size: var(--text-sm);
font-weight: 400;
line-height: 1;
cursor: pointer;
border: 1px solid transparent;
transition:
color var(--motion-fast) var(--ease-standard),
background-color var(--motion-fast) var(--ease-standard),
box-shadow var(--motion-base) var(--ease-standard);
text-decoration: none;
}
.btn:focus-visible {
outline: none;
/* DESIGN.md §7: focus is depth (4 12 0.1), not halo. */
box-shadow: var(--focus-ring);
}
/* Primary — warm-surface CTA. */
.btn-primary {
background: var(--surface-warm);
color: var(--fg);
}
.btn-primary:hover { color: var(--danger); }
.btn-primary:active { background: var(--surface); }
/* Secondary — ghost on warm surface. */
.btn-secondary {
background: transparent;
color: var(--muted);
border-color: var(--border);
}
.btn-secondary:hover {
color: var(--danger);
border-color: rgba(38, 37, 30, 0.2);
}
/* Accent pill — used at most once per screen for the loudest CTA.
This is the only place on the page where --accent is a bg. */
.btn-accent {
background: var(--accent);
color: var(--accent-on);
border-radius: var(--radius-pill);
padding: 10px 18px;
}
.btn-accent:hover { background: var(--accent-hover); }
.btn-accent:active { background: var(--accent-active); }
/* ─── Pill tags ─────────────────────────────────────────── */
/* Cursor's full-pill (9999px) badges/filters — DESIGN.md §4.1. */
.pill {
display: inline-flex;
align-items: center;
gap: var(--space-2);
padding: 3px 10px;
border-radius: var(--radius-pill);
background: var(--surface);
color: var(--meta);
font-family: var(--font-display);
font-size: var(--text-sm);
font-weight: 400;
line-height: 1.5;
}
.pill-active {
background: rgba(38, 37, 30, 0.06); /* deeper surface for selected state */
color: var(--fg);
}
/* ─── Inputs ────────────────────────────────────────────── */
.field {
display: flex;
flex-direction: column;
gap: var(--space-2);
}
.field label {
font-family: var(--font-display);
font-size: var(--text-sm);
font-weight: 500;
color: var(--fg);
}
.field input {
padding: 10px 12px;
border-radius: var(--radius-sm);
border: 1px solid var(--border);
background: var(--bg);
color: var(--fg);
font-family: var(--font-body);
font-size: var(--text-base);
outline: none;
transition:
border-color var(--motion-fast) var(--ease-standard),
box-shadow var(--motion-base) var(--ease-standard);
}
.field input:focus-visible {
outline: none;
border-color: rgba(38, 37, 30, 0.2);
box-shadow: var(--focus-ring);
}
.field input::placeholder { color: var(--meta); }
.field-help {
font-family: var(--font-body);
font-size: var(--text-sm);
color: var(--muted);
}
/* ─── Cards ─────────────────────────────────────────────── */
.card {
background: var(--surface);
border: 1px solid var(--border);
border-radius: var(--radius-sm);
padding: var(--space-5);
display: flex;
flex-direction: column;
gap: var(--space-3);
transition: box-shadow var(--motion-base) var(--ease-standard);
}
.card:hover {
/* DESIGN.md §7: hover shadow intensification (ambient → elevated). */
box-shadow: var(--elev-raised);
}
.card-featured {
/* Featured card uses the larger 10px radius (DESIGN.md §5.4). */
border-radius: var(--radius-md);
background: var(--bg);
}
/* ─── Badges ────────────────────────────────────────────── */
.badge {
display: inline-flex;
align-items: center;
gap: var(--space-2);
padding: 2px var(--space-3);
border-radius: var(--radius-pill);
font-family: var(--font-display);
font-size: var(--text-xs);
font-weight: 500;
line-height: 1.6;
}
.badge-success {
color: var(--success);
background: color-mix(in oklab, var(--success), transparent 90%);
}
.badge-muted {
color: var(--muted);
background: color-mix(in oklab, var(--muted), transparent 88%);
}
.badge-dot {
width: 6px;
height: 6px;
border-radius: 50%;
background: currentColor;
}
/* ─── Links ─────────────────────────────────────────────── */
a {
color: var(--accent);
text-decoration: none;
}
a:hover {
text-decoration: underline;
text-underline-offset: 3px;
text-decoration-color: var(--meta);
}
/* ─── Kbd ───────────────────────────────────────────────── */
kbd {
font-family: var(--font-mono);
font-size: var(--text-xs);
padding: 2px 6px;
border-radius: 4px;
border: 1px solid var(--border);
background: var(--surface);
color: var(--muted);
}
/* ─── AI timeline (decorative, signature element) ──────── */
/* DESIGN.md §4.7 — Cursor's AI timeline shows four states with
soft "warm pastel" colors. These are decorative state markers,
intentionally NOT promoted to brand surface tokens. */
.timeline {
display: flex;
flex-direction: column;
gap: var(--space-3);
padding: var(--space-4);
background: var(--bg);
border: 1px solid var(--border);
border-radius: var(--radius-md);
}
.timeline-step {
display: flex;
align-items: center;
gap: var(--space-3);
font-family: var(--font-mono);
font-size: var(--text-sm);
color: var(--fg-2);
}
.timeline-dot {
width: 8px;
height: 8px;
border-radius: 50%;
flex-shrink: 0;
}
.timeline-thinking .timeline-dot { background: #dfa88f; }
.timeline-grep .timeline-dot { background: #9fc9a2; }
.timeline-read .timeline-dot { background: #9fbbe0; }
.timeline-edit .timeline-dot { background: #c0a8dd; }
/* ─── Section-specific layout ───────────────────────────── */
.hero-grid {
display: grid;
/* Asymmetric hero — keeps the page from looking like an
AI-default centered template. */
grid-template-columns: 1.4fr 1fr;
gap: var(--space-12);
align-items: end;
}
@media (max-width: 1023px) {
.hero-grid { grid-template-columns: 1fr; gap: var(--space-8); }
}
.hero-actions {
display: flex;
gap: var(--space-3);
margin-block-start: var(--space-6);
}
.hero-meta {
display: flex;
flex-direction: column;
gap: var(--space-3);
padding: var(--space-4);
border: 1px solid var(--border);
border-radius: var(--radius-md);
background: var(--bg);
}
.features-grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: var(--space-5);
}
@media (max-width: 1023px) {
.features-grid { grid-template-columns: 1fr 1fr; }
}
@media (max-width: 639px) {
.features-grid { grid-template-columns: 1fr; }
}
.form-row {
display: grid;
grid-template-columns: 1.4fr 1fr;
gap: var(--space-12);
align-items: start;
}
@media (max-width: 1023px) {
.form-row { grid-template-columns: 1fr; }
}
.form {
display: flex;
flex-direction: column;
gap: var(--space-4);
max-width: 420px;
}
.form-actions {
display: flex;
gap: var(--space-3);
margin-block-start: var(--space-2);
}
.filter-row {
display: flex;
gap: var(--space-2);
flex-wrap: wrap;
}
.icon { width: 16px; height: 16px; flex-shrink: 0; }
.row-between {
display: flex;
align-items: center;
justify-content: space-between;
gap: var(--space-3);
}
</style>
</head>
<body>
<main class="container">
<!-- ════════════════════════════════════════════════════════════
HERO — exercises: h1 (CursorGothic 72px / -0.03em),
.lead (jjannon serif), .eyebrow, .btn-primary (warm-surface
CTA + crimson hover), .btn-accent (orange pill, used once
per page max), kbd (berkeleyMono), .badge-success.
═══════════════════════════════════════════════════════════════ -->
<section data-od-id="hero">
<div class="hero-grid">
<div class="stack-4">
<p class="eyebrow">Reference fixture · cursor</p>
<h1>The editor your team writes through, not at.</h1>
<p class="lead" style="max-width: 52ch">
Cursor pairs a serif voice with gothic compression so
feature copy reads like a publication and headlines hit
like an engineered statement. Three fonts, one warm cream
canvas, every value below comes from tokens.css.
</p>
<div class="hero-actions">
<a href="./tokens.css" class="btn btn-accent">
View tokens
<svg
class="icon"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="1.75"
stroke-linecap="round"
stroke-linejoin="round"
aria-hidden="true"
>
<path d="M5 12h14M13 6l6 6-6 6" />
</svg>
</a>
<a href="./DESIGN.md" class="btn btn-primary">Read the spec</a>
</div>
</div>
<aside class="hero-meta" aria-label="System status">
<div class="row-between">
<span class="body-sm">System status</span>
<span class="badge badge-success">
<span class="badge-dot" aria-hidden="true"></span>
Stable
</span>
</div>
<p class="body-sm body-muted">
Last reviewed
<time datetime="2026-05-14">2026-05-14</time> · v0.1
</p>
<p class="body-sm body-muted">
Press <kbd></kbd> <kbd>K</kbd> to search tokens.
</p>
</aside>
</div>
</section>
<!-- ════════════════════════════════════════════════════════════
FEATURES — exercises: h2, h3, .card (warm surface + hover
shadow lift), .body-muted, .pill / .pill-active (full-pill
filter row), .features-grid, AI timeline component (the
cursor signature element).
═══════════════════════════════════════════════════════════════ -->
<section data-od-id="features">
<div class="stack-3">
<p class="eyebrow">What this fixture exercises</p>
<h2 style="max-width: 28ch">
Every component below uses only var(--*) — no raw hex, no
off-token type.
</h2>
</div>
<div class="filter-row" style="margin-block-start: var(--space-6)">
<button class="pill pill-active">All</button>
<button class="pill">Surfaces</button>
<button class="pill">Typography</button>
<button class="pill">Motion</button>
</div>
<div class="features-grid" style="margin-block-start: var(--space-6)">
<article class="card">
<h3>Warm surfaces</h3>
<p class="body-muted body-sm">
--bg, --surface, --surface-warm form a three-tier cream
ladder. Pure white only inside code panels; the page
never reaches it on the canvas.
</p>
<a href="./tokens.css" class="body-sm">Inspect tokens →</a>
</article>
<article class="card">
<h3>Three voices</h3>
<p class="body-muted body-sm">
CursorGothic for display, jjannon serif for body,
berkeleyMono for code. Each voice carries one role; the
system never collapses to two faces.
</p>
<a href="./DESIGN.md" class="body-sm">Read the spec →</a>
</article>
<article class="card card-featured">
<h3>oklab borders</h3>
<p class="body-muted body-sm">
Borders ship as rgba fallbacks of the oklab originals at
0.1 / 0.06 alpha — perceptually uniform across every
warm surface.
</p>
<a href="./tokens.css" class="body-sm">Inspect borders →</a>
</article>
</div>
<div class="timeline" style="margin-block-start: var(--space-8); max-width: 480px">
<p class="eyebrow">AI timeline · signature element</p>
<div class="timeline-step timeline-thinking">
<span class="timeline-dot" aria-hidden="true"></span>
<span>thinking…</span>
</div>
<div class="timeline-step timeline-grep">
<span class="timeline-dot" aria-hidden="true"></span>
<span>grep "tokens.css" -r design-systems/</span>
</div>
<div class="timeline-step timeline-read">
<span class="timeline-dot" aria-hidden="true"></span>
<span>read default/tokens.css</span>
</div>
<div class="timeline-step timeline-edit">
<span class="timeline-dot" aria-hidden="true"></span>
<span>edit cursor/tokens.css → +56 tokens</span>
</div>
</div>
</section>
<!-- ════════════════════════════════════════════════════════════
FORM — exercises: .field (jjannon body input), focus-visible
depth shadow (no halo), .btn-primary (warm-surface CTA),
.btn-secondary (ghost border), .field-help.
═══════════════════════════════════════════════════════════════ -->
<section data-od-id="form">
<div class="form-row">
<div class="stack-4">
<p class="eyebrow">Form components</p>
<h2>Inputs inherit the same tokens.</h2>
<p class="body-muted" style="max-width: 48ch">
The focus state is a soft 4px-12px depth shadow — no
cool-blue halo. Border weights stay at oklab 0.1; on
focus the active border lifts to 0.2.
</p>
</div>
<form class="form" onsubmit="event.preventDefault();">
<div class="field">
<label for="email">Work email</label>
<input
id="email"
type="email"
placeholder="you@team.dev"
autocomplete="email"
required
/>
<p class="field-help">
We'll send the spec PDF and nothing else.
</p>
</div>
<div class="form-actions">
<button type="submit" class="btn btn-primary">
Send the spec
</button>
<button type="button" class="btn btn-secondary">
Skip for now
</button>
</div>
</form>
</div>
</section>
</main>
</body>
</html>