getdesign.mdgetdesign/cursor

Cursor

Warm print-inspired code editor aesthetic with cream canvas, gothic Inter-substitute compression, Fraunces-like serif body, and oklab brown borders.

install

npx designkit-cli add getdesign/cursor
source ↗
previewtemplates · Cursor

Typography

Every text element the kit ships — headings through code

elements

Headings

The quick brown fox

Section heading

Subsection heading

Minor heading

Overline heading

Body text

Lead paragraph.Body text sits at the backbone of any interface — if it reads well, everything else has a chance. If it doesn't, nothing else matters.

Standard paragraph at the body size. Type hierarchies work best when the jump from body to subheading is clear but not disruptive — around 1.25-1.5× works across most contexts. Inline elements like a link, inline code, emphasis, strong, and highlighted text should all feel native to the kit.

Small / caption text — used for metadata, timestamps, descriptions under labels. Usually 14px or slightly smaller.

Lists

Unordered

  • Token-driven styling
  • Agent-readable format
  • Composable kits
    • Colors
    • Typography
    • Component stylings
  • Portable between projects

Ordered

  1. Describe the kit in prose
  2. Extract colors and typography
  3. Apply to a sample UI
  4. Iterate on token values

Blockquote

“Good design is as little design as possible. Less, but better — because it concentrates on the essential aspects, and the products are not burdened with non-essentials.”
— Dieter Rams

Code

// install a kit
$ npx designkit-cli add airbnb

// apply it to your project
import { applyKit } from "@designkit/theme"
applyKit("airbnb")

Rule


Buttons

Primary, secondary, outline, ghost — every state the kit ships

elements

Default

Sizes

With icon

Form fields

Every input control the kit ships — text, select, checkboxes, radios, switches, file

elements

Text inputs

Textarea

Select

Checkboxes

Radio group

Billing cadence

Toggle switch

File input

Feedback

Alerts, badges, progress, tooltips, avatars — the signal surface of every UI

elements

Alerts

!

Scheduled maintenance

We'll be rolling out a new version on Friday at 22:00 UTC. Expect a short read-only window.

!

Kit published

Your DESIGN.md is live. Anyone can now install it with `npx designkit-cli add you/my-kit`.

!

Deprecated API

You're calling /v1/kits which will be removed in 30 days. Migrate to /v2/kits.

!

Build failed

Two component tokens reference an undefined color. Run `designkit lint` to see them.

Badges & tags

OfficialCommunityv2.0BetaDeprecatedOutlineOutline alt

Avatars

JD

Jeremy Dupont

Author

ALMTKPSJ+6

Progress

Upload32%
Build78%
Complete100%

Spinner

Loading…

Tooltip (static)

Tooltip text

Keyboard shortcut

Press K to open the command palette, or Esc to dismiss.

Data display

Table, definition list, empty state — how the kit shows structured data

app

Table

KitAuthorInstallsUpdatedStatus
airbnbgetdesign12.4K2d agoActive
claudegetdesign8.1K5d agoActive
stripegetdesign7.9K1w agoActive
linear.appgetdesign6.2K2w agoBeta
heritagedk2.1K1mo agoDraft

Definition list

Name
Airbnb
Author
getdesign · Claude
Format
DESIGN.md (Google Stitch spec)
Primary font
Nunito (substitute for Airbnb Cereal VF)
Installs
12,408
License
MIT

Empty state

No kits yet

You haven't published any kits on this account. Drop a DESIGN.md in a public repo to get started.

Breadcrumbs

Tabs

Sign in

Centered auth card — the most scrutinised surface in any app

app

Welcome back

Sign in with your work email to continue.

or

New here? Create an account

Dashboard KPIs

Four-card stat row — the staple of every internal dashboard

app

Overview

Performance for the last 30 days

Active users

12,408

+4.2% vs last period

MRR

$28.9K

+12.1% vs last period

Churn

1.8%

-0.3% vs last period

NPS

72

+5 vs last period

[chart placeholder]

Chat thread

Agent + user turn-based chat — bubbles, avatar, timestamp

app
A

Design Agent

online · responds in seconds

Hey — what's the goal of today's session?
I want to ship a pricing page that matches our brand.
Got it. Sharing three variants in a sec — each in your brand tokens so it'll feel native. Which fits better: conversion-first, feature-first, or transparency-first?
Let's try conversion-first.

Hero

Landing-page headline + subtitle + primary CTA

marketing
New · v2.0

Designed for humans. Built for agents.

Ship a brand-aligned product in hours. Coding agents write UI that matches your design system — no brief, no handoff.

Pricing

Three-tier comparison grid with a highlighted middle tier

marketing

Simple pricing

Pay for what you use. Change plans any time.

Hobby

$0forever
  • 1 project
  • Community support
  • Public kits only

Pro

Popular
$19per month
  • Unlimited projects
  • Private kits
  • Priority support
  • AI kit generator

Team

$49per seat / mo
  • Everything in Pro
  • Shared workspace
  • SSO + audit logs
  • Dedicated support

source

---
name: Cursor
description:
  Warm print-inspired code editor aesthetic with cream canvas, gothic
  Inter-substitute compression, Fraunces-like serif body, and oklab brown
  borders.
originalFonts:
  primary: "CursorGothic"
  mono: "berkeleyMono"
  fallbacks:
    - "CursorGothic Fallback"
    - "system-ui"
    - "Helvetica Neue"
    - "Helvetica"
    - "Arial"
colors:
  background: "#f2f1ed"
  surface: "#e6e5e0"
  surface-raised: "#ebeae5"
  ink: "#26251e"
  ink-muted: "rgba(38,37,30,0.55)"
  accent: "#f54e00"
  accent-alt: "#c08532"
  border: "rgba(38,37,30,0.1)"
  link: "#f54e00"
  danger: "#cf2d56"
  success: "#1f8a65"
  cursor-dark: "#26251e"
  cursor-cream: "#f2f1ed"
  cursor-light: "#e6e5e0"
  pure-white: "#ffffff"
  true-black: "#000000"
  cursor-orange: "#f54e00"
  gold: "#c08532"
  error: "#cf2d56"
  thinking: "#dfa88f"
  grep: "#9fc9a2"
  read: "#9fbbe0"
  edit: "#c0a8dd"
  surface-100: "#f7f7f4"
  surface-200: "#f2f1ed"
  surface-300: "#ebeae5"
  surface-400: "#e6e5e0"
  surface-500: "#e1e0db"
  border-strong: "rgba(38,37,30,0.55)"
  border-solid: "#26251e"
  border-light: "#f2f1ed"
typography:
  h1:
    family: "Inter"
    size: "4.5rem"
    weight: 400
    lineHeight: 1.1
  h2:
    family: "Inter"
    size: "2.25rem"
    weight: 400
    lineHeight: 1.2
  h3:
    family: "Inter"
    size: "1.63rem"
    weight: 400
    lineHeight: 1.25
  body:
    family: "Fraunces"
    size: "1.08rem"
    weight: 400
    lineHeight: 1.35
  button:
    family: "Inter"
    size: "0.88rem"
    weight: 400
    lineHeight: 1
  caption:
    family: "Inter"
    size: "0.69rem"
    weight: 400
    lineHeight: 1.5
  code:
    family: "JetBrains Mono"
    size: "0.75rem"
    weight: 400
    lineHeight: 1.67
spacing:
  xs: "0.25rem"
  sm: "0.5rem"
  md: "0.75rem"
  lg: "1.25rem"
  xl: "2rem"
rounded:
  sm: "2px"
  md: "8px"
  lg: "10px"
  xl: "9999px"
shadows:
  sm: "rgba(0,0,0,0.02) 0px 0px 16px, rgba(0,0,0,0.008) 0px 0px 8px"
  md: "rgba(0,0,0,0.1) 0px 4px 12px"
  lg: "rgba(0,0,0,0.14) 0px 28px 70px, rgba(0,0,0,0.1) 0px 14px 32px"
components:
  button-primary:
    background: "{colors.surface-raised}"
    color: "{colors.ink}"
    border: "none"
    radius: "{rounded.md}"
    padding: "10px 14px"
  button-secondary:
    background: "{colors.surface}"
    color: "{colors.ink-muted}"
    border: "1px solid {colors.border}"
    radius: "{rounded.xl}"
    padding: "3px 8px"
  card:
    background: "{colors.surface}"
    border: "1px solid {colors.border}"
    radius: "{rounded.md}"
    padding: "1.5rem"
  input:
    background: "transparent"
    color: "{colors.ink}"
    border: "1px solid {colors.border}"
    radius: "{rounded.md}"
    padding: "0.5rem 0.5rem 0.375rem"
---

<!-- source: VoltAgent/awesome-design-md @ 80bbbc2 (MIT) — see ATTRIBUTION.md -->

# Design System Inspiration of Cursor

## 1. Visual Theme & Atmosphere

Cursor's website is a study in warm minimalism meets code-editor elegance. The
entire experience is built on a warm off-white canvas (`#f2f1ed`) with dark
warm-brown text (`#26251e`) -- not pure black, not neutral gray, but a deeply
warm near-black with a yellowish undertone that evokes old paper, ink, and
craft. This warmth permeates every surface: backgrounds lean toward cream
(`#e6e5e0`, `#ebeae5`), borders dissolve into transparent warm overlays using
`oklab` color space, and even the error state (`#cf2d56`) carries warmth rather
than clinical red. The result feels more like a premium print publication than a
tech website.

The custom CursorGothic font is the typographic signature -- a gothic sans-serif
with aggressive negative letter-spacing at display sizes (-2.16px at 72px) that
creates a compressed, engineered feel. As a secondary voice, the jjannon serif
font (with OpenType `"cswh"` contextual swash alternates) provides literary
counterpoint for body copy and editorial passages. The monospace voice comes
from berkeleyMono, a refined coding font that connects the marketing site to
Cursor's core identity as a code editor. This three-font system (gothic display,
serif body, mono code) gives Cursor one of the most typographically rich
palettes in developer tooling.

The border system is particularly distinctive -- Cursor uses `oklab()` color
space for border colors, applying warm brown at various alpha levels (0.1, 0.2,
0.55) to create borders that feel organic rather than mechanical. The signature
border color `oklab(0.263084 -0.00230259 0.0124794 / 0.1)` is not a simple rgba
value but a perceptually uniform color that maintains visual consistency across
different backgrounds.

**Key Characteristics:**

- CursorGothic with aggressive negative letter-spacing (-2.16px at 72px, -0.72px
  at 36px) for compressed display headings
- jjannon serif for body text with OpenType `"cswh"` (contextual swash
  alternates)
- berkeleyMono for code and technical labels
- Warm off-white background (`#f2f1ed`) instead of pure white -- the entire
  system is warm-shifted
- Primary text color `#26251e` (warm near-black with yellow undertone)
- Accent orange `#f54e00` for brand highlight and links
- oklab-space borders at various alpha levels for perceptually uniform edge
  treatment
- Pill-shaped elements with extreme radius (33.5M px, effectively full-pill)
- 8px base spacing system with fine-grained sub-8px increments (1.5px, 2px,
  2.5px, 3px, 4px, 5px, 6px)

## 2. Color Palette & Roles

### Primary

- **Cursor Dark** (`#26251e`): Primary text, headings, dark UI surfaces. A warm
  near-black with distinct yellow-brown undertone -- the defining color of the
  system.
- **Cursor Cream** (`#f2f1ed`): Page background, primary surface. Not white but
  a warm cream that sets the entire warm tone.
- **Cursor Light** (`#e6e5e0`): Secondary surface, button backgrounds, card
  fills. A slightly warmer, slightly darker cream.
- **Pure White** (`#ffffff`): Used sparingly for maximum contrast elements and
  specific surface highlights.
- **True Black** (`#000000`): Minimal use, specific code/console contexts.

### Accent

- **Cursor Orange** (`#f54e00`): Brand accent, `--color-accent`. A vibrant
  red-orange used for primary CTAs, active links, and brand moments. Warm and
  urgent.
- **Gold** (`#c08532`): Secondary accent, warm gold for premium or highlighted
  contexts.

### Semantic

- **Error** (`#cf2d56`): `--color-error`. A warm crimson-rose rather than cold
  red.
- **Success** (`#1f8a65`): `--color-success`. A muted teal-green, warm-shifted.

### Timeline / Feature Colors

- **Thinking** (`#dfa88f`): Warm peach for "thinking" state in AI timeline.
- **Grep** (`#9fc9a2`): Soft sage green for search/grep operations.
- **Read** (`#9fbbe0`): Soft blue for file reading operations.
- **Edit** (`#c0a8dd`): Soft lavender for editing operations.

### Surface Scale

- **Surface 100** (`#f7f7f4`): Lightest button/card surface, barely tinted.
- **Surface 200** (`#f2f1ed`): Primary page background.
- **Surface 300** (`#ebeae5`): Button default background, subtle emphasis.
- **Surface 400** (`#e6e5e0`): Card backgrounds, secondary surfaces.
- **Surface 500** (`#e1e0db`): Tertiary button background, deeper emphasis.

### Border Colors

- **Border Primary** (`oklab(0.263084 -0.00230259 0.0124794 / 0.1)`): Standard
  border, 10% warm brown in oklab space.
- **Border Medium** (`oklab(0.263084 -0.00230259 0.0124794 / 0.2)`): Emphasized
  border, 20% warm brown.
- **Border Strong** (`rgba(38, 37, 30, 0.55)`): Strong borders, table rules.
- **Border Solid** (`#26251e`): Full-opacity dark border for maximum contrast.
- **Border Light** (`#f2f1ed`): Light border matching page background.

### Shadows & Depth

- **Card Shadow**
  (`rgba(0,0,0,0.14) 0px 28px 70px, rgba(0,0,0,0.1) 0px 14px 32px, oklab(0.263084 -0.00230259 0.0124794 / 0.1) 0px 0px 0px 1px`):
  Heavy elevated card with warm oklab border ring.
- **Ambient Shadow**
  (`rgba(0,0,0,0.02) 0px 0px 16px, rgba(0,0,0,0.008) 0px 0px 8px`): Subtle
  ambient glow for floating elements.

## 3. Typography Rules

### Font Family

- **Display/Headlines**: `CursorGothic`, with fallbacks:
  `CursorGothic Fallback, system-ui, Helvetica Neue, Helvetica, Arial`
- **Body/Editorial**: `jjannon`, with fallbacks:
  `Iowan Old Style, Palatino Linotype, URW Palladio L, P052, ui-serif, Georgia, Cambria, Times New Roman, Times`
- **Code/Technical**: `berkeleyMono`, with fallbacks:
  `ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, Courier New`
- **UI/System**: `system-ui`, with fallbacks:
  `-apple-system, Segoe UI, Helvetica Neue, Arial`
- **Icons**: `CursorIcons16` (icon font at 14px and 12px)
- **OpenType Features**: `"cswh"` on jjannon body text, `"ss09"` on CursorGothic
  buttons/captions

### Hierarchy

| Role            | Font         | Size              | Weight  | Line Height    | Letter Spacing | Notes                                |
| --------------- | ------------ | ----------------- | ------- | -------------- | -------------- | ------------------------------------ |
| Display Hero    | CursorGothic | 72px (4.50rem)    | 400     | 1.10 (tight)   | -2.16px        | Maximum compression, hero statements |
| Section Heading | CursorGothic | 36px (2.25rem)    | 400     | 1.20 (tight)   | -0.72px        | Feature sections, CTA headlines      |
| Sub-heading     | CursorGothic | 26px (1.63rem)    | 400     | 1.25 (tight)   | -0.325px       | Card headings, sub-sections          |
| Title Small     | CursorGothic | 22px (1.38rem)    | 400     | 1.30 (tight)   | -0.11px        | Smaller titles, list headings        |
| Body Serif      | jjannon      | 19.2px (1.20rem)  | 500     | 1.50           | normal         | Editorial body with `"cswh"`         |
| Body Serif SM   | jjannon      | 17.28px (1.08rem) | 400     | 1.35           | normal         | Standard body text, descriptions     |
| Body Sans       | CursorGothic | 16px (1.00rem)    | 400     | 1.50           | normal/0.08px  | UI body text                         |
| Button Label    | CursorGothic | 14px (0.88rem)    | 400     | 1.00 (tight)   | normal         | Primary button text                  |
| Button Caption  | CursorGothic | 14px (0.88rem)    | 400     | 1.50           | 0.14px         | Secondary button with `"ss09"`       |
| Caption         | CursorGothic | 11px (0.69rem)    | 400-500 | 1.50           | normal         | Small captions, metadata             |
| System Heading  | system-ui    | 20px (1.25rem)    | 700     | 1.55           | normal         | System UI headings                   |
| System Caption  | system-ui    | 13px (0.81rem)    | 500-600 | 1.33           | normal         | System UI labels                     |
| System Micro    | system-ui    | 11px (0.69rem)    | 500     | 1.27 (tight)   | 0.048px        | Uppercase micro labels               |
| Mono Body       | berkeleyMono | 12px (0.75rem)    | 400     | 1.67 (relaxed) | normal         | Code blocks                          |
| Mono Small      | berkeleyMono | 11px (0.69rem)    | 400     | 1.33           | -0.275px       | Inline code, terminal                |
| Lato Heading    | Lato         | 16px (1.00rem)    | 600     | 1.33           | normal         | Lato section headings                |
| Lato Caption    | Lato         | 14px (0.88rem)    | 400-600 | 1.33           | normal         | Lato captions                        |
| Lato Micro      | Lato         | 12px (0.75rem)    | 400-600 | 1.27 (tight)   | 0.053px        | Lato small labels                    |

### Principles

- **Gothic compression for impact**: CursorGothic at display sizes uses -2.16px
  letter-spacing at 72px, progressively relaxing: -0.72px at 36px, -0.325px at
  26px, -0.11px at 22px, normal at 16px and below. The tracking creates a sense
  of precision engineering.
- **Serif for soul**: jjannon provides literary warmth. The `"cswh"` feature
  adds contextual swash alternates that give body text a calligraphic quality.
- **Three typographic voices**: Gothic (display/UI), serif (editorial/body),
  mono (code/technical). Each serves a distinct communication purpose.
- **Weight restraint**: CursorGothic uses weight 400 almost exclusively, relying
  on size and tracking for hierarchy rather than weight. System-ui components
  use 500-700 for functional emphasis.

## 4. Component Stylings

### Buttons

**Primary (Warm Surface)**

- Background: `#ebeae5` (Surface 300)
- Text: `#26251e` (Cursor Dark)
- Padding: 10px 12px 10px 14px
- Radius: 8px
- Outline: none
- Hover: text shifts to `var(--color-error)` (`#cf2d56`)
- Focus shadow: `rgba(0,0,0,0.1) 0px 4px 12px`
- Use: Primary actions, main CTAs

**Secondary Pill**

- Background: `#e6e5e0` (Surface 400)
- Text: `oklab(0.263 / 0.6)` (60% warm brown)
- Padding: 3px 8px
- Radius: full pill (33.5M px)
- Hover: text shifts to `var(--color-error)`
- Use: Tags, filters, secondary actions

**Tertiary Pill**

- Background: `#e1e0db` (Surface 500)
- Text: `oklab(0.263 / 0.6)` (60% warm brown)
- Radius: full pill
- Use: Active filter state, selected tags

**Ghost (Transparent)**

- Background: `rgba(38, 37, 30, 0.06)` (6% warm brown)
- Text: `rgba(38, 37, 30, 0.55)` (55% warm brown)
- Padding: 6px 12px
- Use: Tertiary actions, dismiss buttons

**Light Surface**

- Background: `#f7f7f4` (Surface 100) or `#f2f1ed` (Surface 200)
- Text: `#26251e` or `oklab(0.263 / 0.9)` (90%)
- Padding: 0px 8px 1px 12px
- Use: Dropdown triggers, subtle interactive elements

### Cards & Containers

- Background: `#e6e5e0` or `#f2f1ed`
- Border: `1px solid oklab(0.263 / 0.1)` (warm brown at 10%)
- Radius: 8px (standard), 4px (compact), 10px (featured)
- Shadow: `rgba(0,0,0,0.14) 0px 28px 70px, rgba(0,0,0,0.1) 0px 14px 32px` for
  elevated cards
- Hover: shadow intensification

### Inputs & Forms

- Background: transparent or surface
- Text: `#26251e`
- Padding: 8px 8px 6px (textarea)
- Border: `1px solid oklab(0.263 / 0.1)`
- Focus: border shifts to `oklab(0.263 / 0.2)` or accent orange

### Navigation

- Clean horizontal nav on warm cream background
- Cursor logotype left-aligned (~96x24px)
- Links: 14px CursorGothic or system-ui, weight 500
- CTA button: warm surface with Cursor Dark text
- Tab navigation: bottom border `1px solid oklab(0.263 / 0.1)` with active tab
  differentiation

### Image Treatment

- Code editor screenshots with `1px solid oklab(0.263 / 0.1)` border
- Rounded corners: 8px standard
- AI chat/timeline screenshots dominate feature sections
- Warm gradient or solid cream backgrounds behind hero images

### Distinctive Components

**AI Timeline**

- Vertical timeline showing AI operations: thinking (peach), grep (sage), read
  (blue), edit (lavender)
- Each step uses its semantic color with matching text
- Connected with vertical lines
- Core visual metaphor for Cursor's AI-first coding experience

**Code Editor Previews**

- Dark code editor screenshots with warm cream border frame
- berkeleyMono for code text
- Syntax highlighting using timeline colors

**Pricing Cards**

- Warm surface backgrounds with bordered containers
- Feature lists using jjannon serif for readability
- CTA buttons with accent orange or primary dark styling

## 5. Layout Principles

### Spacing System

- Base unit: 8px
- Fine scale: 1.5px, 2px, 2.5px, 3px, 4px, 5px, 6px (sub-8px for
  micro-adjustments)
- Standard scale: 8px, 10px, 12px, 14px (derived from extraction)
- Extended scale (inferred): 16px, 24px, 32px, 48px, 64px, 96px
- Notable: fine-grained sub-8px increments for precise icon/text alignment

### Grid & Container

- Max content width: approximately 1200px
- Hero: centered single-column with generous top padding (80-120px)
- Feature sections: 2-3 column grids for cards and features
- Full-width sections with warm cream or slightly darker backgrounds
- Sidebar layouts for documentation and settings pages

### Whitespace Philosophy

- **Warm negative space**: The cream background means whitespace has warmth and
  texture, unlike cold white minimalism. Large empty areas feel cozy rather than
  clinical.
- **Compressed text, open layout**: Aggressive negative letter-spacing on
  CursorGothic headlines is balanced by generous surrounding margins. Text is
  dense; space around it breathes.
- **Section variation**: Alternating surface tones (cream → lighter cream →
  cream) create subtle section differentiation without harsh boundaries.

### Border Radius Scale

- Micro (1.5px): Fine detail elements
- Small (2px): Inline elements, code spans
- Medium (3px): Small containers, inline badges
- Standard (4px): Cards, images, compact buttons
- Comfortable (8px): Primary buttons, cards, menus
- Featured (10px): Larger containers, featured cards
- Full Pill (33.5M px / 9999px): Pill buttons, tags, badges

## 6. Depth & Elevation

| Level                    | Treatment                                                                   | Use                                         |
| ------------------------ | --------------------------------------------------------------------------- | ------------------------------------------- |
| Flat (Level 0)           | No shadow                                                                   | Page background, text blocks                |
| Border Ring (Level 1)    | `oklab(0.263 / 0.1) 0px 0px 0px 1px`                                        | Standard card/container border (warm oklab) |
| Border Medium (Level 1b) | `oklab(0.263 / 0.2) 0px 0px 0px 1px`                                        | Emphasized borders, active states           |
| Ambient (Level 2)        | `rgba(0,0,0,0.02) 0px 0px 16px, rgba(0,0,0,0.008) 0px 0px 8px`              | Floating elements, subtle glow              |
| Elevated Card (Level 3)  | `rgba(0,0,0,0.14) 0px 28px 70px, rgba(0,0,0,0.1) 0px 14px 32px, oklab ring` | Modals, popovers, elevated cards            |
| Focus                    | `rgba(0,0,0,0.1) 0px 4px 12px` on button focus                              | Interactive focus feedback                  |

**Shadow Philosophy**: Cursor's depth system is built around two ideas. First,
borders use perceptually uniform oklab color space rather than rgba, ensuring
warm brown borders look consistent across different background tones. Second,
elevation shadows use dramatically large blur values (28px, 70px) with moderate
opacity (0.14, 0.1), creating a diffused, atmospheric lift rather than
hard-edged drop shadows. Cards don't feel like they float above the page -- they
feel like the page has gently opened a space for them.

### Decorative Depth

- Warm cream surface variations create subtle tonal depth without shadows
- oklab borders at 10% and 20% create a spectrum of edge definition
- No harsh divider lines -- section separation through background tone shifts
  and spacing

## 7. Interaction & Motion

### Hover States

- Buttons: text color shifts to `--color-error` (`#cf2d56`) on hover -- a
  distinctive warm crimson that signals interactivity
- Links: color shift to accent orange (`#f54e00`) or underline decoration with
  `rgba(38, 37, 30, 0.4)`
- Cards: shadow intensification on hover (ambient → elevated)

### Focus States

- Shadow-based focus: `rgba(0,0,0,0.1) 0px 4px 12px` for depth-based focus
  indication
- Border focus: `oklab(0.263 / 0.2)` (20% border) for input/form focus
- Consistent warm tone in all focus states -- no cold blue focus rings

### Transitions

- Color transitions: 150ms ease for text/background color changes
- Shadow transitions: 200ms ease for elevation changes
- Transform: subtle scale or translate for interactive feedback

## 8. Responsive Behavior

### Breakpoints

| Name          | Width      | Key Changes                                        |
| ------------- | ---------- | -------------------------------------------------- |
| Mobile        | <600px     | Single column, reduced padding, stacked navigation |
| Tablet Small  | 600-768px  | 2-column grids begin                               |
| Tablet        | 768-900px  | Expanded card grids, sidebar appears               |
| Desktop Small | 900-1279px | Full layout forming                                |
| Desktop       | >1279px    | Full layout, maximum content width                 |

### Touch Targets

- Buttons use comfortable padding (6px-14px vertical, 8px-14px horizontal)
- Pill buttons maintain tap-friendly sizing with 3px-10px padding
- Navigation links at 14px with adequate spacing for touch

### Collapsing Strategy

- Hero: 72px CursorGothic → 36px → 26px on smaller screens, maintaining
  proportional letter-spacing
- Navigation: horizontal links → hamburger menu on mobile
- Feature cards: 3-column → 2-column → single column stacked
- Code editor screenshots: maintain aspect ratio, may shrink with border
  treatment preserved
- Timeline visualization: horizontal → vertical stacking
- Section spacing: 80px+ → 48px → 32px on mobile

### Image Behavior

- Editor screenshots maintain warm border treatment at all sizes
- AI timeline adapts from horizontal to vertical layout
- Product screenshots use responsive images with consistent border radius
- Full-width hero images scale proportionally

## 9. Agent Prompt Guide

### Quick Color Reference

- Primary CTA background: `#ebeae5` (warm cream button)
- Page background: `#f2f1ed` (warm off-white)
- Text color: `#26251e` (warm near-black)
- Secondary text: `rgba(38, 37, 30, 0.55)` (55% warm brown)
- Accent: `#f54e00` (orange)
- Error/hover: `#cf2d56` (warm crimson)
- Success: `#1f8a65` (muted teal)
- Border: `oklab(0.263084 -0.00230259 0.0124794 / 0.1)` or
  `rgba(38, 37, 30, 0.1)` as fallback

### Example Component Prompts

- "Create a hero section on `#f2f1ed` warm cream background. Headline at 72px
  CursorGothic weight 400, line-height 1.10, letter-spacing -2.16px, color
  `#26251e`. Subtitle at 17.28px jjannon weight 400, line-height 1.35, color
  `rgba(38,37,30,0.55)`. Primary CTA button (`#ebeae5` bg, 8px radius, 10px 14px
  padding) with hover text shift to `#cf2d56`."
- "Design a card: `#e6e5e0` background, border `1px solid rgba(38,37,30,0.1)`.
  Radius 8px. Title at 22px CursorGothic weight 400, letter-spacing -0.11px.
  Body at 17.28px jjannon weight 400, color `rgba(38,37,30,0.55)`. Use `#f54e00`
  for link accents."
- "Build a pill tag: `#e6e5e0` background, `rgba(38,37,30,0.6)` text, full-pill
  radius (9999px), 3px 8px padding, 14px CursorGothic weight 400."
- "Create navigation: sticky `#f2f1ed` background with backdrop-filter blur.
  14px system-ui weight 500 for links, `#26251e` text. CTA button right-aligned
  with `#ebeae5` bg and 8px radius. Bottom border
  `1px solid rgba(38,37,30,0.1)`."
- "Design an AI timeline showing four steps: Thinking (`#dfa88f`), Grep
  (`#9fc9a2`), Read (`#9fbbe0`), Edit (`#c0a8dd`). Each step: 14px system-ui
  label + 16px CursorGothic description + vertical connecting line in
  `rgba(38,37,30,0.1)`."

### Iteration Guide

1. Always use warm tones -- `#f2f1ed` background, `#26251e` text, never pure
   white/black for primary surfaces
2. Letter-spacing scales with font size for CursorGothic: -2.16px at 72px,
   -0.72px at 36px, -0.325px at 26px, normal at 16px
3. Use `rgba(38, 37, 30, alpha)` as a CSS-compatible fallback for oklab borders
4. Three fonts, three voices: CursorGothic (display/UI), jjannon (editorial),
   berkeleyMono (code)
5. Pill shapes (9999px radius) for tags and filters; 8px radius for primary
   buttons and cards
6. Hover states use `#cf2d56` text color -- the warm crimson shift is a
   signature interaction
7. Shadows use large blur values (28px, 70px) for diffused atmospheric depth
8. The sub-8px spacing scale (1.5, 2, 2.5, 3, 4, 5, 6px) is critical for
   icon/text micro-alignment