tailwindcss.com

DESIGN.md

Narrative design system document — paste directly into Claude Code, Cursor, or Bolt.

---
version: alpha
name: tailwindcss.com
description: "Light product system built on #ffffff with #f73799 as the primary CTA accent. Type anchored in inter at 96px / weight 400. Extracted automatically from https://tailwindcss.com/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
narrative: |
  tailwindcss.com is built on a pure-white canvas (rgb(255,255,255)).
  The system uses rgb(247, 55, 153) as the high-saturation accent for primary actions.
  Generously rounded CTAs (16px) suggest approachable, content-first design alongside inter as the primary typeface.
  Inter is paired with inter Fallback for secondary roles.
  A layered elevation system (17 distinct shadows) building a clear front-to-back hierarchy.
  Motion is a first-class concern — 5 keyframe animations plus transition-driven interactions.

colors:
  background: "#ffffff"
  surface-1: "#ffffff"
  surface-2: "#ffffff"
  primary: "#f73799"
  on-primary: "#111111"
  primary-hover: "#f73799"
  hairline: "#e5e7eb"
  primary-focus: "#101010"

typography:
  display-xl:
    fontFamily: "inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 96px
    fontWeight: 400
    lineHeight: 1
    letterSpacing: -4.8px
  display-md:
    fontFamily: "inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 600
    lineHeight: 1.5
    letterSpacing: 0
  body:
    fontFamily: "inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0
  button:
    fontFamily: "inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 14px
    fontWeight: 600
    lineHeight: 1.71
    letterSpacing: 0

rounded:
  none: 0px
  xs: 4px
  sm: 8px
  md: 12px
  lg: 16px
  xl: 32px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 4px
  sm: 8px
  md: 10px
  lg: 68px
  xl: 76px
  xxl: 92px

components:
  button-pill:
    backgroundColor: "#000000"
    textColor: "{colors.surface-2}"
    typography: "{typography.button}"
    rounded: "{rounded.xl}"
    padding: 8px 16px
  button-ghost:
    backgroundColor: "transparent"
    textColor: "#030712"
    typography: "{typography.button}"
    rounded: "{rounded.pill}"
    padding: 8px 16px
  button-ghost-2:
    backgroundColor: "transparent"
    textColor: "#010712"
    typography: "{typography.display-md}"
    rounded: "{rounded.none}"
    padding: 16px 8px
  input-text-input:
    backgroundColor: "transparent"
    textColor: "#000000"
    typography: "{typography.display-md}"
    rounded: "{rounded.none}"
  tab-pill-tab:
    backgroundColor: "#f6339a"
    textColor: "#e80075"
    typography: "{typography.button}"
    rounded: "{rounded.none}"
    padding: 24px
  code-block-inline-code--pre:
    backgroundColor: "{colors.surface-2}"
    textColor: "#010712"
    typography: "{typography.button}"
    rounded: "{rounded.sm}"
    padding: 12px

extracted_at: "2026-06-11T05:02:41.209Z"
completeness: 63
scoreVersion: "v2"

---

# Design System — tailwindcss.com
> Extracted automatically by Prism from https://tailwindcss.com
> Date: 2026-06-11
> Viewport: Desktop 1440x900 + Mobile 390x844
> Values are extracted, not hand-written: rendered styles via getComputedStyle() + colors declared in CSS custom properties (token-only values are marked `(token)` and may not be painted).

> ⚠️ **LOW-CONFIDENCE CAPTURE** — this extraction likely sampled an app shell / interactive demo, **not** the marketing page. Signals: button labels look like filenames (index.html, app.css); only 0 card component detected. Treat the component, color and copy values below with caution, and re-extract the canonical marketing URL if fidelity matters.


## 0. Design DNA

**Density**: sparse  |  **Motion**: subtle  |  **Weight**: heavy  |  **Aesthetic**: product-neutral

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#ffffff` |
| Type posture | sans-led (inter) | "Rapidly build modern websites " |
| Color assertion | single-accent | #f73799 |
| Whitespace | sparse | section rhythm 84px |
| Interaction | subtle | 5 keyframes, 5 transitions |
| Radius language | 16px-rounded | from token scale |

**Prism fingerprint**: `neutral-canvas · sans-display · single-accent · 16px-rounded · subtle-motion`

> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
>
> - **Canvas**: `rgb(255,255,255)` is the page background. Every component composits against this.
> - **Accent**: `rgb(247, 55, 153)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 84px between major bands. Card padding: 68px.
> - **Default radius**: 8px on buttons/inputs. Pills (`9999px`) only for icon-buttons or status chips.
>
> **Before generating UI**: import this DESIGN.md, scan §2 (Color Palette) + §4 (Components) + §10 (Agent Guide). Skip §11–12 unless extending.

## 1. Visual Theme & Atmosphere

tailwindcss.com uses a pure-white canvas (`#ffffff`), letting typography, color and imagery carry the visual weight. 

Typography is anchored in **inter**, deployed with OpenType features enabled globally (`"cv02", "cv03", "cv04", "cv11"`). These aren't decorative — they're load-bearing: without them, the typeface reverts to its generic state and the design loses its specific texture. Negative letter-spacing at display sizes (-4.8px at 96px) compresses headlines into engineered blocks, dense and precise. 

Body text reads in Black (`#000000`) (contrast ratio 21.0:1, well above WCAG AA). **#f73799** (`#f73799`) is the single high-saturation color in the system — it earns its presence only on interactive elements, making CTAs and links the unmistakable focal points against the otherwise neutral palette. Elevation is built from multi-layer shadow stacks (17 distinct) — each combines several blurred layers at varying offsets to build a clear front-to-back hierarchy. 
Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: White (`#ffffff`)
- Primary typeface: inter
- Accent: #f73799 (`#f73799`)
- Display: 96px weight 400, letter-spacing -4.8px
- Shadow system: 17 distinct elevation levels
- Custom fonts loaded: inter, inter Fallback, source, source Fallback, plexMono, plexMono Fallback, ubuntuMono, ubuntuMono Fallback

## 2. Color Palette & Roles

### Background & Surface
- **White** (`#ffffff`): Page background (primary)

### Text & Content
- **Black** (`#000000`): Primary body text

### CSS Custom Properties (Design Tokens)

**Shadow Token**
- `--tw-inset-shadow-alpha`: `100%`
- `--shadow-xs`: `0 1px 2px 0 #0000000d`
- `--tw-inset-ring-shadow`: `0 0 #0000`
- `--tw-inset-shadow`: `0 0 #0000`

**Error / Destructive**
- `--color-red-900`: `lab(28.5139% 44.5539 29.0463)`
- `--color-red-300`: `lab(76.5514% 36.422 15.5335)`
- `--color-red-600`: `lab(48.4493% 77.4328 61.5452)`
- `--color-red-200`: `lab(86.017% 19.8815 7.75869)`

**Border Radius Token**
- `--radius-4xl`: `2rem`
- `--radius-sm`: `.25rem`
- `--radius-2xl`: `1rem`
- `--radius-md`: `.375rem`

**Warning**
- `--color-yellow-400`: `lab(83.2664% 8.65132 106.895)`
- `--color-amber-300`: `lab(86.4156% 6.13147 78.3961)`
- `--color-yellow-300`: `lab(89.7033% -.480294 84.4917)`
- `--color-yellow-950`: `lab(16.8146% 15.7422 23.1133)`

**Success**
- `--color-green-500`: `lab(70.5521% -66.5147 45.8073)`
- `--color-green-900`: `lab(30.797% -29.6927 17.382)`
- `--color-green-600`: `lab(59.0978% -58.6621 41.2579)`
- `--color-green-950`: `lab(15.6845% -20.4225 11.7249)`

**Font Weight Token**
- `--font-weight-bold`: `700`
- `--font-weight-extralight`: `200`
- `--font-weight-thin`: `100`
- `--font-weight-light`: `300`

**Spacing Token**
- `--tw-space-x-reverse`: `0`
- `--spacing`: `.25rem`
- `--tw-border-spacing-y`: `0px`
- `--tw-space-y-reverse`: `0`

**Motion Token**
- `--default-transition-duration`: `.15s`
- `--default-transition-timing-function`: `cubic-bezier(.4, 0, .2, 1)`

**Font Family Token**
- `--default-font-family`: `"inter", "inter Fallback", system-ui`
- `--default-mono-font-family`: `"plexMono", "plexMono Fallback", monospace`

**Other tokens**
- `--color-purple-200`: `lab(87.8405% 13.4282 -18.7159)`
- `--color-purple-300`: `lab(78.3298% 26.2195 -34.9499)`
- `--default-font-feature-settings`: `"cv02", "cv03", "cv04", "cv11"`
- `--color-mauve-800`: `lab(14.1786% 6.35938 -5.68258)`
- `--color-zinc-100`: `lab(96.1634% .0993311 -.364041)`
- `--color-zinc-200`: `lab(90.6853% .399232 -1.45452)`
- `--color-rose-200`: `lab(86.806% 19.1909 4.07754)`
- `--color-slate-200`: `lab(91.7353% -.998765 -4.76968)`

## 3. Typography Rules

### Font Families
- **Primary**: `inter`
- **Secondary**: `inter Fallback`
- **Font 3**: `source`
- **Font 4**: `source Fallback`
- **Font 5**: `plexMono`

### Custom Fonts Loaded
- **inter** weight 100 900 (normal)
- **inter Fallback** weight normal (normal)
- **source** weight 500 (normal)
- **source Fallback** weight normal (normal)
- **plexMono** weight 400 (normal)
- **plexMono** weight 500 (normal)
- **plexMono** weight 600 (normal)
- **plexMono Fallback** weight normal (normal)
- **ubuntuMono** weight 600 (normal)
- **ubuntuMono Fallback** weight normal (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | inter | 96px | 400 | 1 | -4.8px | Main headline (h1) |
| Sub-heading | inter | 16px | 600 | 1.5 | normal | Third-level heading (h3) |
| Body | inter | 16px | 400 | 1.5 | normal | Standard reading text |
| Button | inter | 14px | 600 | 1.71 | normal | Button label (14px) |
| Button | inter | 14px | 400 | 1.71 | normal | Button label (14px) |
| Button Small | inter | 12px | 500 | 1.67 | normal | Button label (12px) |

### Font Weight Scale

CSS custom properties define 9 explicit weight steps:
- `--font-weight-thin`: `100` — Thin
- `--font-weight-extralight`: `200` — ExtraLight
- `--font-weight-light`: `300` — Light
- `--font-weight-normal`: `400` — Regular
- `--font-weight-medium`: `500` — Medium
- `--font-weight-semibold`: `600` — SemiBold
- `--font-weight-bold`: `700` — Bold
- `--font-weight-extrabold`: `800` — ExtraBold
- `--font-weight-black`: `900` — Black

### Full Font Size Scale

Sizes detected in the design (descending): `96px`, `40px`, `36px`, `30px`, `24px`, `20px`, `18px`, `17px`, `16px`, `14px`, `13px`, `12px`

> 8 size(s) detected outside the sampled hierarchy (40px, 36px, 30px, 24px, 20px, 18px, 17px, 13px). These appear on elements not in the sampled set — likely additional display sizes, marketing-section overrides, or third-party-widget styles.

### OpenType & Variable Font Features

The typography uses these OpenType features intentionally — this is a sophisticated type system, not a default fallback:

- **tabular figures** (`tnum`) — numbers align vertically, essential for pricing tables and dashboards
- **old-style figures** (`onum`) — varying-height numerals, editorial feel
- **stylistic sets** (`ss0X`) — alternate letterforms enabled (often for brand-specific glyph variants)
- **slashed zero** (`zero`) — distinguishes 0 from O, useful for code/data

**Clone instruction:** Enable these in your CSS:
```css
body {
  font-feature-settings: "cv02", "cv03", "cv04", "cv11", "ss02", "zero", "tnum", "smcp", "onum";
}
```

## 4. Component Stylings

### Buttons

**Pill**
- Background: `#000000`
- Text: `#ffffff` `{colors.surface-2}`
- Padding: 8px 16px
- Radius: 32px
- Font: 14px weight 600
- Use: Status pills, tags, chips
- Hover: backgroundColor: `#030712`
- Focus: outline: `rgb(16, 16, 16) auto 1px`

**Ghost**
- Background: `transparent`
- Text: `#030712`
- Padding: 8px 16px
- Radius: 9999px
- Shadow: `oklab(0.129999 -0.00404751 -0.027702 / 0.08) 0px 0px 0px 1px inset`
- Font: 14px weight 400
- Use: Subtle action, toolbar, nav button
- Hover: backgroundColor: `#030712`
- Focus: outline: `rgb(16, 16, 16) auto 1px`

**Ghost**
- Background: `transparent`
- Text: `#010712`
- Padding: 16px 8px
- Radius: 0px
- Font: 16px weight 400
- Use: Subtle action, toolbar, nav button
- Hover: backgroundColor: `#030712`
- Focus: outline: `rgb(16, 16, 16) auto 1px`

**Primary Brand**
- Background: `#f73799` `{colors.primary-hover}`
- Text: `#ffffff` `{colors.surface-2}`
- Padding: 8px 12px
- Radius: 8px
- Font: 14px weight 700
- Use: Primary CTA / brand action
- Hover: backgroundColor: `#030712`
- Focus: outline: `rgb(16, 16, 16) auto 1px`

### Inputs & Forms

**Text Input**
- Background: `transparent`
- Text: `#000000`
- Padding: 0px
- Radius: 0px
- Border: 0px solid rgb(0, 0, 0)
- Font: 16px weight 400
- Use: Text fields, search inputs
- Focus: outline: `rgb(16, 16, 16) auto 1px`

### Tabs

**Pill Tab**
- Background: `#f6339a`
- Text: `#e80075`
- Padding: 24px
- Radius: 0px
- Font: 14px weight 400
- Use: Navigation tabs, filter tabs

### Code Blocks

**Inline Code / Pre**
- Background: `#ffffff` `{colors.surface-2}`
- Text: `#010712`
- Padding: 12px
- Radius: 8px
- Font: 13px weight 400 — plexMono
- Use: Code samples, CLI commands, syntax highlighting blocks


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative

- **Button**:
  - **hover:** bg #030712 → #030712

*State transitions extracted via Playwright simulation — exact values in the YAML matrix below.*

```yaml
component-behaviors:
  button:
    default:
      bg: "oklab(0.129999 -0.00404751 -0.027702 / 0.05)"
      fg: "lab(1.90334 0.278696 -5.48866)"
    hover:
      bg: "oklab(0.129999 -0.00404751 -0.027702 / 0.075)"
      fg: "inherit"
    focus:
      bg: "transparent"
      fg: "inherit"
  input:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 0)"
    focus:
      bg: "transparent"
      fg: "inherit"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 0)"
  tab:
    default:
      bg: "oklab(0.656006 0.239783 -0.0238809 / 0.05)"
      fg: "lab(49.5493 79.8381 2.31768)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "lab(1.90334 0.278696 -5.48866)"
```

**Agent usage**: Validate generated components against this matrix. If your output's `:hover` state changes properties not listed here, you are off-brand.


## 4c. Component Vocabulary (Closed System)

*This brand uses ONLY the following component vocabulary. Introducing new variants without justification breaks the system's tonal coherence.*

### Buttons
- **3 shape(s)** in this system: `Pill`, `Ghost`, `Primary Brand`
- **DO NOT introduce new buttons variants** without justification

### Inputs & Forms
- **1 shape(s)** in this system: `Text Input`
- **DO NOT introduce new inputs & forms variants** without justification

### Tabs
- **1 shape(s)** in this system: `Pill Tab`
- **DO NOT introduce new tabs variants** without justification

### Code Blocks
- **1 shape(s)** in this system: `Inline Code / Pre`
- **DO NOT introduce new code blocks variants** without justification

## 5. Layout Principles

### Layout Type
**top-nav + content**

### Grid
Single column, centered content

### Max Width
1200px

### Spacing System
Generous spacing — editorial breathing room

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 4px |
| sm | 8px |
| md | 10px |
| base | 32px |
| lg | 68px |
| xl | 76px |
| 2xl | 84px |
| 3xl | 92px |

### Border Radius Scale
| Name | Value | Use |
|------|-------|-----|
| None | 0px | No rounding |
| Xs | 4px | Tiny corners (badges, micro elements) |
| Sm | 8px | Buttons, inputs, small elements |
| Md | 12px | Cards, containers |
| Lg | 16px | Large rounded elements, pill segments |
| Xl | 32px | Category strips, featured containers |
| Full | 9999px | Pills, avatars, circular elements |

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `32px` |
| Inputs & Forms | `0px` |
| Tabs | `0px` |
| Code Blocks | `8px` |
| Page Body | `0px` |
| Primary Input | `0px` |

**Shape Personality**: Generously Rounded — Soft, friendly corners (8px+). Approachable, consumer-facing feel.

**Full Radius Spectrum**: 0px, 4px, 6px, 7px, 8px, 12px, 16px, 24px (from `allBorderRadii` scan)


## 5b. Spacing Rhythm Names

*Named spacing tokens with explicit use cases. Use these names in YOUR code instead of raw pixels for consistency.*

| Name | Value | Use case |
|------|-------|----------|
| **hero** | `92px` | Top/bottom of full-bleed hero sections |
| **section** | `76px` | Between major bands (color change, content shift) |
| **subsection** | `68px` | Within a section, between content groups |
| **card** | `10px` | Card padding, list-item spacing |
| **compact** | `8px` | Form fields, tight clusters, badge padding |
| **micro** | `4px` | Icon-text gap, tag inner padding |

**Agent rule**: NEVER hardcode raw pixel values for spacing in generated UI. Always reference these named tokens (`spacing-rhythm.section`, etc.).

## 5c. Widget & Structure Library

Structural patterns extracted from the page DOM — these are the **blueprints** an agent should follow to reproduce the page architecture (not just CSS values).

**3/8 structural patterns detected.**

### Hero Pattern

- **Composition:** left-aligned — 
- **Viewport coverage:** 192px tall (not full-viewport)
- **Heading:** "Rapidly build modern websites without ever leaving your HTML." — 96px left-aligned
- **CTAs:** none detected in hero (unusual — agent should verify)
- **Clone instruction:** Reproduce the **left-aligned** layout. Use the heading font-size token at the documented size. Pair the centered text with the hero’s decorative visual (gradient / SVG / hero image — see §9b), not bare text.

### Card Grid Pattern

- **Card count:** 3 cards detected
- **Columns (desktop):** 1-up grid
- **Card dimensions:** 2163×1241px (aspect 1.74:1)
- **Gap:** 0px between cards
- **Content:** ✗ no image
- **Clone instruction:** Build a 1-column grid (desktop) with cards at ~1.74:1 aspect ratio. Text/icon-only cards (no photography).

### Footer Pattern

- **Columns:** 4
- **Links:** 16 total
- **Height:** 328px
- **Includes:** ✗ no newsletter | ✓ social icons |  
- **Clone instruction:** Build a 4-column footer with ~4 links per column, social media links.

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |
| Inset (Level 1) | `oklab(0.129999 -0.00404751 -0.027702 / 0.08) 0px 0px 0px 1px inset` | Buttons, pressed-state elements |
| Inset (Level 2) | `oklab(0.999994 0.0000455678 0.0000200868 / 0.1) 0px 0px 0px 1px inset` | Buttons, pressed-state elements |
| Layered (Level 3) | <br>`rgba(0, 0, 0, 0.1) 0px 20px 25px -5px`,<br>`rgba(0, 0, 0, 0.1) 0px 8px 10px -6px` | Cards, elevated surfaces |
| Subtle (Level 4) | `oklab(0.129999 -0.00404751 -0.027702 / 0.05) 0px 0px 0px 1px` | Cards, dividers, borders |

**Shadow Philosophy**: Multi-layered shadow system creating natural, atmospheric depth. Each shadow level combines multiple layers for realistic elevation.

## 7. Motion & Interaction

### Easing System

| CSS Variable | Curve | Semantic Name |
|--------------|-------|---------------|
| `--ease-in` | `cubic-bezier(.4, 0, 1, 1)` | Custom Ease — Balanced |
| `--default-transition-timing-function` | `cubic-bezier(.4, 0, .2, 1)` | Ease Out — Decelerating |
| `--ease-out` | `cubic-bezier(0, 0, .2, 1)` | Ease Out — Decelerating |
| `--ease-in-out` | `cubic-bezier(.4, 0, .2, 1)` | Ease Out — Decelerating |

### Duration Scale

| CSS Variable | Value | Tier |
|--------------|-------|------|
| `--default-transition-duration` | `.15s` | Fast |

### Copy-Paste Transition Snippets

**All Props**
```css
transition: border-radius 0.35s cubic-bezier(0.4, 0, 0.2, 1);
```

**All Props**
```css
transition: font-size 0.35s cubic-bezier(0.4, 0, 0.2, 1);
```

**Color / Background**
```css
transition: color 0.35s cubic-bezier(0.4, 0, 0.2, 1), background-color 0.35s cubic-bezier(0.4, 0, 0.2, 1), border-color 0.35s cub...;
```

**Color / Background**
```css
transition: color 0.15s cubic-bezier(0.4, 0, 0.2, 1), background-color 0.15s cubic-bezier(0.4, 0, 0.2, 1), border-color 0.15s cub...;
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `spin` | Rotate / Spin | transform | Loading indicator |
| `ping` | Fade + Move | opacity, transform | Attention / status |
| `pulse` | Fade | opacity | Attention / status |
| `bounce` | Slide | animation-timing-function, transform | Playful feedback |
| `flash-code` | Color Pulse | background-color | UI transition |

### Motion Fingerprint

- **Speed Character**: Deliberate & Calm (median duration: `350ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 5 unique animations (5 total including variants)

> This design moves with deliberate & calm timing using custom cubic-bezier curves, creating a UI that feels calm and controlled.

## 8. Do's and Don'ts

### Do
- Use inter as the primary typeface — it defines the brand personality
- Use negative letter-spacing (-4.8px) at display sizes for compressed, editorial headlines
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use #f73799 (`#f73799`) as the primary accent — it's the brand's signature interactive color
- Use 8px border-radius on buttons — the standard corner rounding for interactive elements
- Transition button background to Jet Black (`#030712`) on hover — this is the extracted interactive state
- Respect the 4px–76px spacing range — the design uses a wide scale for visual breathing room

### Don't
- Don't substitute with generic sans-serif or serif — the custom font carries the brand
- Don't increase letter-spacing on headings — the type is designed to run tight at scale
- Don't invent new shadow values — use only the extracted shadow levels
- Don't introduce additional saturated accent colors — the palette is intentionally controlled
- Don't use opacity or brightness filter for button hover — the design uses an explicit background color change


## 7b. Enforceable Brand Rules

*Structured Do/Don't with reasoning and validation tests. Agents can programmatically verify generated UI.*

```yaml
rules:
  - id: brand-canvas-001
    type: do
    rule: "Always use the page background `rgb(255,255,255)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(255,255,255)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `rgb(247, 55, 153)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(247, 55, 153)\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 640px | Single column layout |
| Tablet | 768px | 2-column grids |
| Desktop | 1024px | Full layout |
| Large Desktop | 1280px | Maximum width |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `96px` | `36px` |
| heading | font-weight | `400` | `500` |
| heading | line-height | `96px` | `40px` |
| heading | letter-spacing | `-4.8px` | `-1.8px` |

### Collapsing Strategy
- Headlines: 96px → 36px on mobile
- Navigation: horizontal links → hamburger menu on mobile
- Cards: multi-column → stacked vertical on mobile
- Footer: multi-column → stacked single column on mobile

### Touch Targets
- Buttons: 2px 6px 2px 10px padding
- Navigation: adequate spacing between items
- Interactive elements: minimum 44px touch target recommended

### Collapsing Narrative

How the structural patterns adapt from desktop to mobile (extracted from both viewport extractions):

- **Footer columns collapse:** 4 columns (desktop) → 2 columns (mobile).


## 7c. Visual Effects & Dynamic Behavior

*The live/dynamic layer beyond static CSS — reproduce these, not flat substitutes. This is often what separates a faithful clone from a wireframe.*

- **Clip-path shapes** — 8 non-rectangular cut(s).

> **Motion fingerprint**: non-rectangular shapes (9)

## 9b. Visual Tone & Photography

**Tone:** Illustration-driven

The site relies primarily on illustrations, vector art, and decorative SVG elements rather than photography. Use commissioned illustrations, icon sets, or generated graphics for clones — stock photos will feel off-brand.

**Canonical Brand Image (OG):**
- https://tailwindcss.com/opengraph-image.jpg?opengraph-image.0jwfhnd690..4.jpg (1200×630px)
  *This is the image shown when the site is shared on social media — represents the brand visual essence.*

**Hero Image (above-fold dominant visual):**
- Aspect: 0.99:1 (square / portrait)
- Rendered size: 190×192px
- *Use this aspect ratio + composition for your clone's hero — mimicking the proportion preserves the visual hierarchy.*

**Aspect Ratio Distribution:**
- Landscape (1.15–2.3): 8 (27%)
- Portrait (<0.87): 13 (43%)
- Square (0.87–1.15): 8 (27%)
- Ultra-wide (>2.3): 1 (3%)

**Media Format Mix:**
- JPG: 1 (typically photographic content)
- PNG: 14 (logos, transparent UI elements, mockups)
- SVG: 36 (icons, illustrations, decorative geometry)

**Average rendered image size:** 455×401px
**Above-fold image count:** 1 / 30

**Decorative Patterns Detected:**
- 1 multi-stop linear gradient (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth
- 5 radial gradients — circular color blooms used for spotlight/glow effects
- 36 large decorative SVG shapes (≥200×200px, non-icon) — likely blob/illustration accents
- **Glassmorphism** detected (`backdrop-filter: blur`) — layered transparent surfaces with blur, modern OS-like aesthetic

**Clone instruction for decorative work:** This is a gradient-rich design — invest in multi-stop CSS gradients (3+ color stops), not solid backgrounds.

**Imagery Guidance for clones:**
- Use vector illustration as the primary visual language — photos will read as off-brand.
- Maintain consistent illustration style (line weight, color palette) across the site.

## 10. Agent Prompt Guide

### Quick Reference
- Background: White (`#ffffff`)
- Primary text: Black (`#000000`)
- Accent: #f73799 (`#f73799`)
- Border: Whitesmoke (`#e5e7eb`)
- Font: inter
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on White background (#ffffff). Headline at 96px inter weight 400, line-height 1, letter-spacing -4.8px, color #000000."
- "Create the primary CTA button: `#f73799` background, `#ffffff` text, 8px border-radius, 8px 12px padding, 700 weight, inter font."
- "Build navigation: sticky on `#ffffff`. inter 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to White (`#ffffff`) — every component is composited against this exact base.
2. **Typography**: All type in inter, weight range 100–900. Never exceed 900 — heavier weights break the brand's tonal restraint.
3. **Accent**: #f73799 (`#f73799`) is the sole interactive color. On hover → #f73799 (`#f73799`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.4,0,0.2,1)`. Timing: 150ms for micro-interactions, 150ms for layout changes. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `16px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (4px–76px). All padding, margin, and gap values are multiples from this scale — no magic numbers.
7. **Tokens**: Import from §11 CSS Export (`--ca-*` vars). Never hardcode hex values — always reference a token so theming remains consistent.

## 11. CSS Design Tokens Raw Export

*Copy-paste ready `:root {}` block — all values extracted directly from the live site.*

```css
/* Colors */
:root {
  --ca-surface-2: #ffffff;
  --ca-primary-hover: #f73799;
  --ca-on-primary: #111111;
  --ca-hairline: #e5e7eb;
  --ca-primary-focus: #101010;
}

/* Typography */
:root {
  --ca-font-primary: "inter", system-ui, sans-serif;
  --ca-text-display: 96px;
  --ca-text-body: 16px;
  --ca-text-button: 14px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 4px;
  --ca-space-sm: 8px;
  --ca-space-md: 10px;
  --ca-space-base: 32px;
  --ca-space-lg: 68px;
  --ca-space-xl: 76px;
  --ca-space-2xl: 84px;
  --ca-space-3xl: 92px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 4px;
  --ca-radius-sm: 8px;
  --ca-radius-md: 12px;
  --ca-radius-lg: 16px;
  --ca-radius-xl: 32px;
  --ca-radius-full: 9999px;
}

/* Motion */
:root {
  --ca-ease-in: cubic-bezier(.4, 0, 1, 1);
  --ca-ease-out: cubic-bezier(0, 0, .2, 1);
  --ca-ease-in-out: cubic-bezier(.4, 0, .2, 1);
}
```


## 13. Page Structure Skeleton

*The actual layout the source site uses. Reproduce these sections in order to match the site structure.*

```yaml
page-skeleton:
  - section: hero
    tag: div
    classes: ["isolate"]
    height: 11649px
    width: full-bleed
    layout: block
    children: 1
  - section: feature-section
    tag: div
    height: 972px
    width: 1360px
    layout: block
    children: 7
  - section: unknown
    tag: div
    classes: ["@container", "rounded-3xl", "bg-black/5", "p-2"]
    height: 344px
    width: 262px
    layout: block
    children: 1
    bg: "oklab(0 0 0 / 0.05)"
    padding: "8px"
  - section: feature-section
    tag: div
    classes: ["relative", "max-w-full"]
    height: 1714px
    width: 1360px
    layout: block
    children: 7
  - section: section
    tag: section
    height: 1402px
    width: 1360px
    layout: block
    children: 1
  - section: content-section
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 640px
    width: 1344px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: testimonials
    tag: div
    classes: ["@container", "max-sm:mr-0!"]
    height: 416px
    width: 768px
    layout: block
    children: 1
    vertical-padding: ~32px
  - section: unknown
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 640px
    width: 668px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: unknown
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 640px
    width: 668px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: unknown
    tag: div
    classes: ["@container", "relative", "flex", "size-full"]
    height: 448px
    width: 652px
    layout: flex-row justify=center
    children: 2
  - section: unknown
    tag: div
    classes: ["@container"]
    height: 448px
    width: 588px
    layout: block
    children: 1
  - section: content-section
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 640px
    width: 533px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: content-section
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 640px
    width: 803px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: unknown
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 640px
    width: 668px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: content-section
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 640px
    width: 668px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: content-section
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 720px
    width: 443px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: content-section
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 720px
    width: 443px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: content-section
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 720px
    width: 443px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: unknown
    tag: div
    classes: ["@container", "relative", "isolate", "flex"]
    height: 448px
    width: 427px
    layout: flex-row justify=center
    children: 2
  - section: feature-section
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 640px
    width: 668px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: unknown
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 640px
    width: 668px
    layout: flex-column justify=normal
    children: 3
    bg: "rgb(255, 255, 255)"
    padding: "8px"
  - section: feature-section
    tag: div
    classes: ["relative", "max-w-full"]
    height: 838px
    width: 1360px
    layout: block
    children: 6
  - section: content-section
    tag: div
    classes: ["@container", "rounded-xl", "bg-gray-950", "in-[figure]:-mx-1"]
    height: 562px
    width: 1344px
    layout: block
    children: 1
    bg: "lab(1.90334 0.278696 -5.48866)"
  - section: feature-section
    tag: div
    classes: ["relative", "max-w-full"]
    height: 1301px
    width: 1360px
    layout: block
    children: 6
  - section: unknown
    tag: div
    classes: ["@container", "isolate", "flex", "flex-col"]
    height: 981px
    width: 1344px
    layout: flex-row justify=normal
    children: 5
    bg: "rgb(255, 255, 255)"
```

**Agent rule**: rebuild sections in this order (sorted by vertical position). Match the layout primitive (grid N-col / flex direction / block).


## 14. Copy Library (Real Content from Source)

*Actual text content extracted from the live page. Use these strings verbatim when reproducing the site — they carry the brand voice.*

```yaml
copy:
  section-headings:
    - "Supported by the best."
    - "Build whatever you want, without touching your CSS file."
  sub-headings:
    - "Browse properties"
    - "Redefining real-time performance"
    - "Tailwind CSS"
  ctas:
    - "v4.3"
    - "Ctrl K"
    - "Get started"
    - "Quick search Ctrl K"
    - "Become a sponsor"
    - "Check availability"
    - "index.html"
    - "app.css"
  footer-links:
    - "Documentation"
    - "Tailwind Plus"
```

**Agent rule**: reuse these exact strings when generating UI. Do NOT translate or rephrase — brand voice is preserved through the original wording.


## 15. Asset Inventory (Image Roles & Ratios)

*Image inventory classified by role and aspect ratio. When reproducing the site, allocate this number of assets per role.*

```yaml
assets:
  product:
    count: 10
    avg-ratio: 1.07
    common-aspect: "~1:1 square"
  editorial:
    count: 8
    avg-ratio: 0.53
    common-aspect: "~9:16 portrait"
  thumbnail:
    count: 7
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
```

**Agent rule**: when generating placeholder images, match these counts and aspect ratios. Use neutral placeholder backgrounds for `product` (e.g. `#f5f5f5`), full-color photography hints for `hero` and `editorial`.


## 16. Component HTML Templates

*Suggested HTML markup for reproducing the key components — based on what was detected in the source DOM.*

### Button (primary action)
```html
<button class="btn btn-primary">
  v4.3
</button>
```
_Source pattern detected: padding `2px 6px 2px 10px` · radius `16px` · weight `500`_

**Agent rule**: use these markup skeletons as the structural baseline. Apply tokens from §2-3 for visual styling.


## 17. Content Architecture & Resources (Links by Purpose)

*The page's links classified by purpose — the information architecture to reproduce. Categories, featured images, devices and projects are extracted from the rendered DOM, not guessed.*

**By purpose:** **cta** 1 · **docs** 2 · **blog** 1 · **project** 1 · **social** 2 · **footer** 10 · **other** 43

**Primary actions (conversion path):**
- Primary call-to-action — "Get started" (the conversion path) → `https://tailwindcss.com/docs/installation`

**Signals:** 44/60 links carry a featured image · device mockups detected: laptop ×1, tablet ×2, phone ×1 · dominant link roles: logo-link (36), footer-link (11), content-card (9).


## 11.5 Design System — Consolidated across 4 pages

Measured across **(home), docs, partners, plus**: which tokens hold site-wide (the real design system) vs page-specific noise. Consistency = % of distinct tokens shared across ≥2 of 4 pages. "system" = tokens on ALL 4 pages (the real design-system primitives).

**Overall token consistency: 53%**

| Category | Consistency | Distinct | System tokens (on every page) |
|---|---:|---:|---|
| Colors | 100% | 2 | `rgb(0, 0, 0)`, `rgb(255, 255, 255)` |
| Font families | 50% | 4 | — |
| Font sizes | 53% | 17 | `16px`, `12px`, `14px`, `18px` |
| Border radii | 46% | 13 | `16px`, `3.35544e+07px`, `6px` |
| Shadows | 18% | 22 | — |

> High consistency = a disciplined system to reproduce verbatim; low = per-page divergence to warn the agent about. Measured, not asserted.


---
## Extraction Completeness: 63/100 (C)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 3 | 25 | 2 named colors |
| Typography | 15 | 20 | 6 roles defined |
| Components | 16 | 20 | 4 specs extracted |
| Motion & Interaction | 15 | 15 | Keyframes, easing vars |
| CSS Custom Properties | 10 | 10 | 493 vars |
| Responsive Breakpoints | 4 | 5 | 4 breakpoints |
| Variable Fonts | 0 | 5 | None detected |

## 12. Known Gaps & Confidence

Explicit list of what this extraction could NOT capture. Agents should not invent values for these — either skip the feature or use the documented baseline + heuristic fallback.

*Auto-detected extraction limitations — understand before building:*

- **Sparse component extraction** — fewer than 5 component types detected. Highly dynamic sections (modals, datepickers, carousels) require interaction to render and are not captured in a static pass.

*✅ No critical extraction gaps detected — high-confidence reproduction expected.*

### Per-section confidence

| Section | Confidence | Reason |
|---------|------------|--------|
| §1 Visual Theme | High | Body bg extracted via getComputedStyle() |
| §2 Colors | High | 493 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 6 typography roles inferred |
| §4 Components | Medium | 4 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 12 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 4 breakpoints detected |
| §9b Photography | High | 30 images, hero present |

---
*Generated by Prism — automated Playwright extraction + design analysis.*
*Source: https://tailwindcss.com | 2026-06-11T05:02:41.230Z*
*Values extracted via getComputedStyle() (rendered) + CSS custom properties (tokens, marked `(token)`). Token-only values may not be painted — verify against the live site before shipping.*