getdesign.mdgetdesign/sanity

Sanity

Nocturnal command center with near-black canvas, achromatic gray scale, vivid neon/blue/coral accents, and pill-shaped primary CTAs.

install

npx designkit-cli add getdesign/sanity
source ↗
previewtemplates · Sanity

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: Sanity
description:
  Nocturnal command center with near-black canvas, achromatic gray scale, vivid
  neon/blue/coral accents, and pill-shaped primary CTAs.
originalFonts:
  primary: "waldenburgNormal"
  mono: "IBM Plex Mono"
  fallbacks:
    - "waldenburgNormal Fallback"
    - "ui-sans-serif"
    - "system-ui"
colors:
  background: "#0b0b0b"
  surface: "#212121"
  surface-raised: "#353535"
  ink: "#ffffff"
  ink-muted: "#b9b9b9"
  accent: "#f36458"
  accent-alt: "#0052ef"
  border: "#212121"
  link: "#0052ef"
  sanity-black: "#0b0b0b"
  pure-black: "#000000"
  sanity-red: "#f36458"
  electric-blue: "#0052ef"
  light-blue: "#55beff"
  light-blue-alt: "#afe3ff"
  neon-green: "#19d600"
  accent-magenta: "#f500ff"
  near-black: "#0b0b0b"
  dark-gray: "#212121"
  medium-dark: "#353535"
  pure-white: "#ffffff"
  light-gray: "#ededed"
  white: "#ffffff"
  silver: "#b9b9b9"
  medium-gray: "#797979"
  charcoal: "#212121"
  error-red: "#dd0000"
  gpc-green: "#37cd84"
  focus-ring-blue: "#0052ef"
  dark-border: "#0b0b0b"
  subtle-border: "#212121"
  medium-border: "#353535"
  light-border: "#ffffff"
typography:
  h1:
    family: "Inter"
    size: "7rem"
    weight: 400
    lineHeight: 1.0
  h2:
    family: "Inter"
    size: "4.5rem"
    weight: 400
    lineHeight: 1.05
  h3:
    family: "Inter"
    size: "3rem"
    weight: 400
    lineHeight: 1.08
  body:
    family: "Inter"
    size: "1rem"
    weight: 400
    lineHeight: 1.5
  code:
    family: "JetBrains Mono"
    size: "0.94rem"
    weight: 400
    lineHeight: 1.5
spacing:
  xs: "0.5rem"
  sm: "0.75rem"
  md: "1rem"
  lg: "2rem"
  xl: "6rem"
rounded:
  sm: "3px"
  md: "6px"
  lg: "12px"
  xl: "99999px"
shadows:
  sm: "0px 0px 0px 1px #212121"
  md: "0px 0px 0px 2px #0052ef"
components:
  button-primary:
    background: "{colors.sanity-red}"
    color: "{colors.pure-white}"
    border: "none"
    radius: "{rounded.xl}"
    padding: "8px 16px"
  button-secondary:
    background: "{colors.near-black}"
    color: "{colors.silver}"
    border: "none"
    radius: "{rounded.xl}"
    padding: "8px 12px"
  button-ghost:
    background: "{colors.dark-gray}"
    color: "{colors.silver}"
    border: "1px solid {colors.dark-gray}"
    radius: "5px"
    padding: "0px 12px"
  card:
    background: "{colors.surface}"
    border: "1px solid {colors.medium-border}"
    radius: "{rounded.md}"
    padding: "1.5rem"
  input:
    background: "{colors.near-black}"
    color: "{colors.silver}"
    border: "1px solid {colors.subtle-border}"
    radius: "{rounded.sm}"
    padding: "8px 12px"
---

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

# Design System Inspiration of Sanity

## 1. Visual Theme & Atmosphere

Sanity's website is a developer-content platform rendered as a nocturnal command
center -- dark, precise, and deeply structured. The entire experience sits on a
near-black canvas (`#0b0b0b`) that reads less like a "dark mode toggle" and more
like the natural state of a tool built for people who live in terminals. Where
most CMS marketing pages reach for friendly pastels and soft illustration,
Sanity leans into the gravity of its own product: structured content deserves a
structured stage.

The signature typographic voice is waldenburgNormal -- a distinctive, slightly
geometric sans-serif with tight negative letter-spacing (-0.32px to -4.48px at
display sizes) that gives headlines a compressed, engineered quality. At 112px
hero scale with -4.48px tracking, the type feels almost machined -- like
precision-cut steel letterforms. This is paired with IBM Plex Mono for code and
technical labels, creating a dual-register voice: editorial authority meets
developer credibility.

What makes Sanity distinctive is the interplay between its monochromatic dark
palette and vivid, saturated accent punctuation. The neutral scale runs from
pure black through a tightly controlled gray ramp (`#0b0b0b` -> `#212121` ->
`#353535` -> `#797979` -> `#b9b9b9` -> `#ededed` -> `#ffffff`) with no warm or
cool bias -- just pure, achromatic precision. Against this disciplined backdrop,
a neon green accent (display-p3 green) and electric blue (`#0052ef`) land with
the impact of signal lights in a dark control room. The orange-red CTA
(`#f36458`) provides the only warm touch in an otherwise cool system.

**Key Characteristics:**

- Near-black canvas (`#0b0b0b`) as the default, natural environment -- not a
  dark "mode" but the primary identity
- waldenburgNormal with extreme negative tracking at display sizes, creating a
  precision-engineered typographic voice
- Pure achromatic gray scale -- no warm or cool undertones, pure neutral
  discipline
- Vivid accent punctuation: neon green, electric blue (`#0052ef`), and coral-red
  (`#f36458`) against the dark field
- Pill-shaped primary buttons (99999px radius) contrasting with subtle rounded
  rectangles (3-6px) for secondary actions
- IBM Plex Mono as the technical counterweight to the editorial display face
- Full-bleed dark sections with content contained in measured max-width
  containers
- Hover states that shift to electric blue (`#0052ef`) across all interactive
  elements -- a consistent "activation" signal

## 2. Color Palette & Roles

### Primary Brand

- **Sanity Black** (`#0b0b0b`): The primary canvas and dominant surface color.
  Not pure black but close enough to feel absolute. The foundation of the entire
  visual identity.
- **Pure Black** (`#000000`): Used for maximum-contrast moments, deep overlays,
  and certain border accents.
- **Sanity Red** (`#f36458`): The primary CTA and brand accent -- a warm
  coral-red that serves as the main call-to-action color. Used for "Get Started"
  buttons and primary conversion points.

### Accent & Interactive

- **Electric Blue** (`#0052ef`): The universal hover/active state color across
  the entire system. Buttons, links, and interactive elements all shift to this
  blue on hover. Also used as `--color-blue-700` for focus rings and active
  states.
- **Light Blue** (`#55beff` / `#afe3ff`): Secondary blue variants used for
  accent backgrounds, badges, and dimmed blue surfaces.
- **Neon Green** (`color(display-p3 .270588 1 0)`): A vivid, wide-gamut green
  used as `--color-fg-accent-green` for success states and premium feature
  highlights. Falls back to `#19d600` in sRGB.
- **Accent Magenta** (`color(display-p3 .960784 0 1)`): A vivid wide-gamut
  magenta for specialized accent moments.

### Surface & Background

- **Near Black** (`#0b0b0b`): Default page background and primary surface.
- **Dark Gray** (`#212121`): Elevated surface color for cards, secondary
  containers, input backgrounds, and subtle layering above the base canvas.
- **Medium Dark** (`#353535`): Tertiary surface and border color for creating
  depth between dark layers.
- **Pure White** (`#ffffff`): Used for inverted sections, light-on-dark text,
  and specific button surfaces.
- **Light Gray** (`#ededed`): Light surface for inverted/light sections and
  subtle background tints.

### Neutrals & Text

- **White** (`#ffffff`): Primary text color on dark surfaces, maximum
  legibility.
- **Silver** (`#b9b9b9`): Secondary text, body copy on dark surfaces, muted
  descriptions, and placeholder text.
- **Medium Gray** (`#797979`): Tertiary text, metadata, timestamps, and
  de-emphasized content.
- **Charcoal** (`#212121`): Text on light/inverted surfaces.
- **Near Black Text** (`#0b0b0b`): Primary text on white/light button surfaces.

### Semantic

- **Error Red** (`#dd0000`): Destructive actions, validation errors, and
  critical warnings -- a pure, high-saturation red.
- **GPC Green** (`#37cd84`): Privacy/compliance indicator green.
- **Focus Ring Blue** (`#0052ef`): Focus ring color for accessibility, matching
  the interactive blue.

### Border System

- **Dark Border** (`#0b0b0b`): Primary border on dark containers -- barely
  visible, maintaining minimal containment.
- **Subtle Border** (`#212121`): Standard border for inputs, textareas, and card
  edges on dark surfaces.
- **Medium Border** (`#353535`): More visible borders for emphasized containment
  and dividers.
- **Light Border** (`#ffffff`): Border on inverted/light elements or buttons
  needing contrast separation.
- **Orange Border** (`color(display-p3 1 0.3333 0)`): Special accent border for
  highlighted/featured elements.

## 3. Typography Rules

### Font Family

- **Display / Headline**: `waldenburgNormal`, fallback:
  `waldenburgNormal Fallback, ui-sans-serif, system-ui`
- **Body / UI**: `waldenburgNormal`, fallback:
  `waldenburgNormal Fallback, ui-sans-serif, system-ui`
- **Code / Technical**: `IBM Plex Mono`, fallback:
  `ibmPlexMono Fallback, ui-monospace`
- **Fallback / CJK**: `Helvetica`, fallback:
  `Arial, Hiragino Sans GB, STXihei, Microsoft YaHei, WenQuanYi Micro Hei`

_Note: waldenburgNormal is a custom typeface. For external implementations, use
Inter or Space Grotesk as the sans substitute (geometric, slightly condensed
feel). IBM Plex Mono is available on Google Fonts._

### Hierarchy

| Role            | Font             | Size           | Weight  | Line Height  | Letter Spacing | Notes                               |
| --------------- | ---------------- | -------------- | ------- | ------------ | -------------- | ----------------------------------- |
| Display / Hero  | waldenburgNormal | 112px (7rem)   | 400     | 1.00 (tight) | -4.48px        | Maximum impact, compressed tracking |
| Hero Secondary  | waldenburgNormal | 72px (4.5rem)  | 400     | 1.05 (tight) | -2.88px        | Large section headers               |
| Section Heading | waldenburgNormal | 48px (3rem)    | 400     | 1.08 (tight) | -1.68px        | Primary section anchors             |
| Heading Large   | waldenburgNormal | 38px (2.38rem) | 400     | 1.10 (tight) | -1.14px        | Feature section titles              |
| Heading Medium  | waldenburgNormal | 32px (2rem)    | 425     | 1.24 (tight) | -0.32px        | Card titles, subsection headers     |
| Heading Small   | waldenburgNormal | 24px (1.5rem)  | 425     | 1.24 (tight) | -0.24px        | Smaller feature headings            |
| Subheading      | waldenburgNormal | 20px (1.25rem) | 425     | 1.13 (tight) | -0.2px         | Sub-section markers                 |
| Body Large      | waldenburgNormal | 18px (1.13rem) | 400     | 1.50         | -0.18px        | Intro paragraphs, descriptions      |
| Body            | waldenburgNormal | 16px (1rem)    | 400     | 1.50         | normal         | Standard body text                  |
| Body Small      | waldenburgNormal | 15px (0.94rem) | 400     | 1.50         | -0.15px        | Compact body text                   |
| Caption         | waldenburgNormal | 13px (0.81rem) | 400-500 | 1.30-1.50    | -0.13px        | Metadata, descriptions, tags        |
| Small Caption   | waldenburgNormal | 12px (0.75rem) | 400     | 1.50         | -0.12px        | Footnotes, timestamps               |
| Micro / Label   | waldenburgNormal | 11px (0.69rem) | 500-600 | 1.00-1.50    | normal         | Uppercase labels, tiny badges       |
| Code Body       | IBM Plex Mono    | 15px (0.94rem) | 400     | 1.50         | normal         | Code blocks, technical content      |
| Code Caption    | IBM Plex Mono    | 13px (0.81rem) | 400-500 | 1.30-1.50    | normal         | Inline code, small technical labels |
| Code Micro      | IBM Plex Mono    | 10-12px        | 400     | 1.30-1.50    | normal         | Tiny code labels, uppercase tags    |

### Principles

- **Extreme negative tracking at scale**: Display headings at 72px+ use
  aggressive negative letter-spacing (-2.88px to -4.48px), creating a tight,
  engineered quality that distinguishes Sanity from looser editorial typography.
- **Single font, multiple registers**: waldenburgNormal handles both editorial
  display and functional UI text. The weight range is narrow (400-425 for most,
  500-600 only for tiny labels), keeping the voice consistent.
- **OpenType feature control**: Typography uses deliberate feature settings
  including `"cv01", "cv11", "cv12", "cv13", "ss07"` for display sizes and
  `"calt" 0` for body text, fine-tuning character alternates for different
  contexts.
- **Tight headings, relaxed body**: Headings use 1.00-1.24 line-height
  (extremely tight), while body text breathes at 1.50. This contrast creates
  clear visual hierarchy.
- **Uppercase for technical labels**: IBM Plex Mono captions and small labels
  frequently use `text-transform: uppercase` with tight line-heights, creating a
  "system readout" aesthetic for technical metadata.

## 4. Component Stylings

### Buttons

**Primary CTA (Pill)**

- Background: Sanity Red (`#f36458`)
- Text: White (`#ffffff`)
- Padding: 8px 16px
- Border Radius: 99999px (full pill)
- Border: none
- Hover: Electric Blue (`#0052ef`) background, white text
- Font: 16px waldenburgNormal, weight 400

**Secondary (Dark Pill)**

- Background: Near Black (`#0b0b0b`)
- Text: Silver (`#b9b9b9`)
- Padding: 8px 12px
- Border Radius: 99999px (full pill)
- Border: none
- Hover: Electric Blue (`#0052ef`) background, white text

**Outlined (Light Pill)**

- Background: White (`#ffffff`)
- Text: Near Black (`#0b0b0b`)
- Padding: 8px
- Border Radius: 99999px (full pill)
- Border: 1px solid `#0b0b0b`
- Hover: Electric Blue (`#0052ef`) background, white text

**Ghost / Subtle**

- Background: Dark Gray (`#212121`)
- Text: Silver (`#b9b9b9`)
- Padding: 0px 12px
- Border Radius: 5px
- Border: 1px solid `#212121`
- Hover: Electric Blue (`#0052ef`) background, white text

**Uppercase Label Button**

- Font: 11px waldenburgNormal, weight 600, uppercase
- Background: transparent or `#212121`
- Text: Silver (`#b9b9b9`)
- Letter-spacing: normal
- Used for tab-like navigation and filter controls

### Cards

**Dark Content Card**

- Background: `#212121`
- Border: 1px solid `#353535` or `#212121`
- Border Radius: 6px
- Padding: 24px
- Text: White (`#ffffff`) for titles, Silver (`#b9b9b9`) for body
- Hover: subtle border color shift or elevation change

**Feature Card (Full-bleed)**

- Background: `#0b0b0b` or full-bleed image/gradient
- Border: none or 1px solid `#212121`
- Border Radius: 12px
- Padding: 32-48px
- Contains large imagery with overlaid text

### Inputs

**Text Input / Textarea**

- Background: Near Black (`#0b0b0b`)
- Text: Silver (`#b9b9b9`)
- Border: 1px solid `#212121`
- Padding: 8px 12px
- Border Radius: 3px
- Focus: outline with `var(--focus-ring-color)` (blue), 2px solid
- Focus background: shifts to deep cyan (`#072227`)

**Search Input**

- Background: `#0b0b0b`
- Text: Silver (`#b9b9b9`)
- Padding: 0px 12px
- Border Radius: 3px
- Placeholder: Medium Gray (`#797979`)

### Navigation

**Top Navigation**

- Background: Near Black (`#0b0b0b`) with backdrop blur
- Height: auto, compact padding
- Logo: left-aligned, Sanity wordmark
- Links: waldenburgNormal 16px, Silver (`#b9b9b9`)
- Link Hover: Electric Blue via `--color-fg-accent-blue`
- CTA Button: Sanity Red pill button right-aligned
- Separator: 1px border-bottom `#212121`

**Footer**

- Background: Near Black (`#0b0b0b`)
- Multi-column link layout
- Links: Silver (`#b9b9b9`), hover to blue
- Section headers: White (`#ffffff`), 13px uppercase IBM Plex Mono

### Badges / Pills

**Neutral Subtle**

- Background: White (`#ffffff`)
- Text: Near Black (`#0b0b0b`)
- Padding: 8px
- Font: 13px
- Border Radius: 99999px

**Neutral Filled**

- Background: Near Black (`#0b0b0b`)
- Text: White (`#ffffff`)
- Padding: 8px
- Font: 13px
- Border Radius: 99999px

## 5. Layout Principles

### Spacing System

Base unit: **8px**

| Token    | Value    | Usage                                                     |
| -------- | -------- | --------------------------------------------------------- |
| space-1  | 1px      | Hairline gaps, border-like spacing                        |
| space-2  | 2px      | Minimal internal padding                                  |
| space-3  | 4px      | Tight component internal spacing                          |
| space-4  | 6px      | Small element gaps                                        |
| space-5  | 8px      | Base unit -- button padding, input padding, badge padding |
| space-6  | 12px     | Standard component gap, button horizontal padding         |
| space-7  | 16px     | Section internal padding, card spacing                    |
| space-8  | 24px     | Large component padding, card internal spacing            |
| space-9  | 32px     | Section padding, container gutters                        |
| space-10 | 48px     | Large section vertical spacing                            |
| space-11 | 64px     | Major section breaks                                      |
| space-12 | 96-120px | Hero vertical padding, maximum section spacing            |

### Grid & Container

- Max content width: ~1440px (inferred from breakpoints)
- Page gutter: 32px on desktop, 16px on mobile
- Content sections use full-bleed backgrounds with centered, max-width content
- Multi-column layouts: 2-3 columns on desktop, single column on mobile
- Card grids: CSS Grid with consistent gaps (16-24px)

### Whitespace Philosophy

Sanity uses aggressive vertical spacing between sections (64-120px) to create
breathing room on the dark canvas. Within sections, spacing is tighter
(16-32px), creating dense information clusters separated by generous voids. This
rhythm gives the page a "slides" quality -- each section feels like its own
focused frame.

### Border Radius Scale

| Token       | Value   | Usage                                  |
| ----------- | ------- | -------------------------------------- |
| radius-xs   | 3px     | Inputs, textareas, subtle rounding     |
| radius-sm   | 4-5px   | Secondary buttons, small cards, tags   |
| radius-md   | 6px     | Standard cards, containers             |
| radius-lg   | 12px    | Large cards, feature containers, forms |
| radius-pill | 99999px | Primary buttons, badges, nav pills     |

## 6. Depth & Elevation

### Shadow System

| Level             | Value                                 | Usage                                                                             |
| ----------------- | ------------------------------------- | --------------------------------------------------------------------------------- |
| Level 0 (Flat)    | none                                  | Default state for most elements -- dark surfaces create depth through color alone |
| Level 1 (Subtle)  | 0px 0px 0px 1px `#212121`             | Border-like shadow for minimal containment without visible borders                |
| Level 2 (Focus)   | 0 0 0 2px `var(--color-blue-500)`     | Focus ring for inputs and interactive elements                                    |
| Level 3 (Overlay) | Backdrop blur + semi-transparent dark | Navigation overlay, modal backgrounds                                             |

### Depth Philosophy

Sanity's depth system is almost entirely **colorimetric** rather than
shadow-based. Elevation is communicated through surface color shifts: `#0b0b0b`
(ground) -> `#212121` (elevated) -> `#353535` (prominent) -> `#ffffff`
(inverted/highest). This approach is native to dark interfaces where traditional
drop shadows would be invisible. The few shadows that exist are ring-based (0px
0px 0px Npx) or blur-based (backdrop-filter) rather than offset shadows,
maintaining the flat, precision-engineered aesthetic.

Border-based containment (1px solid `#212121` or `#353535`) serves as the
primary spatial separator, with the border darkness calibrated to be visible but
not dominant. The system avoids "floating card" aesthetics -- everything feels
mounted to the surface rather than hovering above it.

## 7. Do's and Don'ts

### Do

- Use the achromatic gray scale as the foundation -- maintain pure neutral
  discipline with no warm/cool tinting
- Apply Electric Blue (`#0052ef`) consistently as the universal hover/active
  state across all interactive elements
- Use extreme negative letter-spacing (-2px to -4.48px) on display headings 48px
  and above
- Keep primary CTAs as full-pill shapes (99999px radius) with the coral-red
  (`#f36458`)
- Use IBM Plex Mono uppercase for technical labels, tags, and system metadata
- Communicate depth through surface color (dark-to-light) rather than shadows
- Maintain generous vertical section spacing (64-120px) on the dark canvas
- Use `"cv01", "cv11", "cv12", "cv13", "ss07"` OpenType features for display
  typography

### Don't

- Don't introduce warm or cool color tints to the neutral scale -- Sanity's
  grays are pure achromatic
- Don't use drop shadows for elevation -- dark interfaces demand colorimetric
  depth
- Don't apply border-radius between 13px and 99998px -- the system jumps from
  12px (large card) directly to pill (99999px)
- Don't mix the coral-red CTA with the electric blue interactive color in the
  same element
- Don't use heavy font weights (700+) -- the system maxes out at 600 and only
  for 11px uppercase labels
- Don't place light text on light surfaces or dark text on dark surfaces without
  checking the gray-on-gray contrast ratio
- Don't use traditional offset box-shadows -- ring shadows (0 0 0 Npx) or
  border-based containment only
- Don't break the tight line-height on headings -- 1.00-1.24 is the range, never
  go to 1.5+ for display text

## 8. Responsive Behavior

### Breakpoints

| Name             | Width     | Behavior                             |
| ---------------- | --------- | ------------------------------------ |
| Desktop XL       | >= 1640px | Full layout, maximum content width   |
| Desktop          | >= 1440px | Standard desktop layout              |
| Desktop Compact  | >= 1200px | Slightly condensed desktop           |
| Laptop           | >= 1100px | Reduced column widths                |
| Tablet Landscape | >= 960px  | 2-column layouts begin collapsing    |
| Tablet           | >= 768px  | Transition zone, some elements stack |
| Mobile Large     | >= 720px  | Near-tablet layout                   |
| Mobile           | >= 480px  | Single-column, stacked layout        |
| Mobile Small     | >= 376px  | Minimum supported width              |

### Collapsing Strategy

- **Navigation**: Horizontal links collapse to hamburger menu below 768px
- **Hero typography**: Scales from 112px -> 72px -> 48px -> 38px across
  breakpoints, maintaining tight letter-spacing ratios
- **Grid layouts**: 3-column -> 2-column at ~960px, single-column below 768px
- **Card grids**: Horizontal scrolling on mobile instead of wrapping (preserving
  card aspect ratios)
- **Section spacing**: Vertical padding reduces by ~40% on mobile (120px -> 64px
  -> 48px)
- **Button sizing**: CTA pills maintain padding but reduce font size; ghost
  buttons stay fixed
- **Code blocks**: Horizontal scroll with preserved monospace formatting

### Mobile-Specific Adjustments

- Full-bleed sections extend edge-to-edge with 16px internal gutters
- Touch targets: minimum 44px for all interactive elements
- Heading letter-spacing relaxes slightly at mobile sizes (less aggressive
  negative tracking)
- Image containers switch from fixed aspect ratios to full-width with auto
  height

## 9. Agent Prompt Guide

### Quick Color Reference

```
Background:      #0b0b0b (near-black canvas)
Surface:         #212121 (elevated cards/containers)
Border:          #353535 (visible) / #212121 (subtle)
Text Primary:    #ffffff (white on dark)
Text Secondary:  #b9b9b9 (silver on dark)
Text Tertiary:   #797979 (medium gray)
CTA:             #f36458 (coral-red)
Interactive:     #0052ef (electric blue, all hovers)
Success:         #19d600 (green, sRGB fallback)
Error:           #dd0000 (pure red)
Light Surface:   #ededed / #ffffff (inverted sections)
```

### Example Prompts

**Landing page section:** "Create a feature section with a near-black (#0b0b0b)
background. Use a 48px heading in Inter with -1.68px letter-spacing, white text.
Below it, 16px body text in #b9b9b9 with 1.50 line-height. Include a coral-red
(#f36458) pill button with white text and a secondary dark (#0b0b0b) pill button
with #b9b9b9 text. Both buttons hover to #0052ef blue."

**Card grid:** "Build a 3-column card grid on a #0b0b0b background. Each card
has a #212121 surface, 1px solid #353535 border, 6px border-radius, and 24px
padding. Card titles are 24px white with -0.24px letter-spacing. Body text is
13px #b9b9b9. Add a 13px IBM Plex Mono uppercase tag in #797979 at the top of
each card."

**Form section:** "Design a contact form on a #0b0b0b background. Inputs have
#0b0b0b background, 1px solid #212121 border, 3px border-radius, 8px 12px
padding, and #b9b9b9 placeholder text. Focus state shows a 2px blue (#0052ef)
ring. Submit button is a full-width coral-red (#f36458) pill. Include a 13px
#797979 helper text below each field."

**Navigation bar:** "Create a sticky top navigation on #0b0b0b with backdrop
blur. Left: brand text in 15px white. Center/right: nav links in 16px #b9b9b9
that hover to blue. Far right: a coral-red (#f36458) pill CTA button. Bottom
border: 1px solid #212121."

### Iteration Guide

1. **Start dark**: Begin with `#0b0b0b` background, `#ffffff` primary text,
   `#b9b9b9` secondary text
2. **Add structure**: Use `#212121` surfaces and `#353535` borders for
   containment -- no shadows
3. **Apply typography**: Inter (or Space Grotesk) with tight letter-spacing on
   headings, 1.50 line-height on body
4. **Color punctuation**: Add `#f36458` for CTAs and `#0052ef` for all
   hover/interactive states
5. **Refine spacing**: 8px base unit, 24-32px within sections, 64-120px between
   sections
6. **Technical details**: Add IBM Plex Mono uppercase labels for tags and
   metadata
7. **Polish**: Ensure all interactive elements hover to `#0052ef`, all buttons
   are pills or subtle 5px radius, borders are hairline (1px)