theverge.com

DESIGN.md

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

---
version: alpha
name: theverge.com
description: "Dark-canvas product system built on #131313 with #3cffd0 as the single brand accent. Type anchored in ui-sans-serif at 48px / weight 600. Extracted automatically from https://theverge.com/ — every value from getComputedStyle(), no approximation."
narrative: |
  theverge.com is built on a near-black canvas (rgb(19, 19, 19)).
  The system uses #3cffd0 as the high-saturation accent for primary actions.
  Crisp CTAs (1px radius) reinforce a precise, technical aesthetic alongside Roboto as the primary typeface.

colors:
  canvas: "#131313"
  surface-1: "#131313"
  surface-2: "#222222"
  ink-muted: "#e9e9e9"
  ink-subtle: "#949494"
  primary: "#3cffd0"
  on-primary: "#ffffff"
  primary-hover: "#3cffd0"
  hairline: "rgba(255,255,255,0.08)"
  primary-focus: "#3cffd0"

typography:
  display-xl:
    fontFamily: "__polySans_9afc27"
    fontSize: 24px
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: 0.24px
  body:
    fontFamily: "ui-sans-serif"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0
  body-sm:
    fontFamily: "Courier New"
    fontSize: 11px
    fontWeight: 400
    lineHeight: 1.18
    letterSpacing: 1.1px
  button:
    fontFamily: "Courier New"
    fontSize: 12px
    fontWeight: 600
    lineHeight: 2
    letterSpacing: 1.5px
  mono:
    fontFamily: "__polySans_9afc27"
    fontSize: 18px
    fontWeight: 400
    lineHeight: 1
    letterSpacing: 0

rounded:
  none: 0px
  xs: 3px
  sm: 3px
  md: 24px
  lg: 24px
  xl: 30px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 4px
  sm: 8px
  md: 10px
  lg: 40px
  xl: 45px
  xxl: 120px
  section: 80px

components:
  button-icon-button:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  button-outline:
    backgroundColor: "transparent"
    textColor: "{colors.primary-focus}"
    typography: "{typography.body-sm}"
    rounded: "{rounded.none}"
    padding: 0px 20px
  button-ghost:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 14px 0px 14px 14px
  card-standard-card:
    backgroundColor: "transparent"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  input-text-input:
    backgroundColor: "{colors.hairline}"
    textColor: "#000000"
    typography: "{typography.mono}"
    rounded: "{rounded.xs}"
    padding: 20px 45px 20px 20px
  navigation-main-nav:
    backgroundColor: "transparent"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 8px 0px 0px
  cta-banner-full-width-cta:
    backgroundColor: "transparent"
    textColor: "{colors.primary-focus}"
    typography: "{typography.body-sm}"
    rounded: "{rounded.none}"
    padding: 0px 20px
  tab-ghost-tab:
    backgroundColor: "transparent"
    textColor: "#000000"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  tab-pill-tab:
    backgroundColor: "{colors.primary-focus}"
    textColor: "#000000"
    typography: "{typography.button}"
    rounded: "{rounded.md}"
    padding: 10px 24px

extracted_at: "2026-05-30T20:40:10.154Z"
completeness: 74
scoreVersion: "v2"

---

# Design System — theverge.com
> Extracted automatically by Clone Architect from https://theverge.com
> Date: 2026-05-30
> Viewport: Desktop 1440x900 + Mobile 390x844
> Every value in this file comes from real getComputedStyle() — no approximation.

> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
>
> - **Canvas**: `rgb(19, 19, 19)` is the page background. Every component composits against this.
> - **Accent**: `#3cffd0` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 70px between major bands. Card padding: 40px.
> - **Default radius**: 3px 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

theverge.com commits fully to dark-mode as the native medium, not as a toggled alternative. The canvas is a dark surface (`#131313`) where surfaces are layered through stepped luminance — each elevated level is slightly less dark than the one beneath it, creating depth without color shifts. 

Typography is anchored in **ui-sans-serif**. Headlines run at a remarkably light weight (0) — restraint over assertion, creating an editorial calm that invites reading rather than demanding it. 

Body text reads in Pure Black (`#000000`) — slightly under-bright, preventing eye strain on the dark surface. **#3cffd0** (`#3cffd0`) provides interactive distinction without visual aggression. Elevation is built from multi-layer shadow stacks — each level combines several blurred layers at varying offsets to simulate the way light actually falls on stacked surfaces, not the simulated drop-shadow of cheap interfaces. 


**Key Characteristics:**
- Background: Jet Black (`#131313`)
- Primary typeface: ui-sans-serif
- Primary text: #3cffd0 (`#3cffd0`)
- Accent: #3cffd0 (`#3cffd0`)
- Shadow system: 6 distinct elevation levels

## 2. Color Palette & Roles

### Background & Surface
- **Jet Black** (`#131313`): Page background (primary)
- **Pure Black** (`#000000`): Surface / elevated background
- **Warm Brown** (`#222222`): Surface / elevated background
- **Dark Gray** (`#4a4a4a`): Surface / elevated background
- **Charcoal** (`#313131`): Surface / elevated background

### Text & Content
- **Pure Black** (`#000000`): Primary body text
- **#3cffd0** (`#3cffd0`): Secondary text
- **Cool Gray** (`#949494`): Secondary text

### Accent & Interactive
- **#5200ff** (`#5200ff`): Interactive / accent
- **#3d00bf** (`#3d00bf`): Interactive / accent

### Full Extracted Palette
19 distinct colors detected on the live page (9 categorized above + 10 additional below). Every value is a real `getComputedStyle()` color — no approximation.

- `#e9e9e9` — Light Gray
- `#ffffff` — Pure White
- `#a980ff` — #a980ff
- `#d6f31f` — #d6f31f
- `#ffd5c8` — Pink
- `#bdbdbd` — Silver
- `#5a5a5a` — Slate
- `#efefef` — Light Gray
- `#fffcd4` — Beige
- `#36c7a3` — #36c7a3

### CSS Custom Properties (Design Tokens)

**Secondary Color**
- `--coral-sys-color-subtle`: `#949494`
- `--coral-sys-color-muted`: `#e9e9e9`

**Background**
- `--coral-sys-color-surface`: `#313131`
- `--coral-sys-color-background`: `#131313`

**Primary Brand Color**
- `--coral-sys-color-primaryText`: `#3cffd0`
- `--coral-sys-color-primary`: `#3cffd0`

**Shadow Token**
- `--coral-sys-global-link-standard-boxShadow`: `inset 0 -1px 0 0 currentColor`
- `--coral-sys-global-link-standard-hover-boxShadow`: `inset 0 -1px 0 0 #3cffd0`

**Spacing Token**
- `--coral-comp-coral-comment-typography-letterSpacing`: `0px`
- `--coral-comp-coral-meta-typography-letterSpacing`: `0.02em`
- `--coral-comp-coral-username-typography-letterSpacing`: `0px`

**Font Weight Token**
- `--coral-sys-global-font-bold-fontWeight`: `700`

**Other tokens**
- `--coral-comp-coral-primary-color`: `#3cffd0`
- `--coral-comp-coral-onPrimary-color`: `#000`
- `--coral-sys-color-prominent`: `#fff`
- `--coral-sys-color-light`: `#313131`
- `--coral-sys-global-font-regular-fontWeight`: `400`
- `--coral-sys-color-onPrimary`: `#000`
- `--coral-comp-coral-comment-rec-color`: `#313131`
- `--_1tsb0yebg`: `inset 0 0 0 0 transparent`

## 3. Typography Rules

### Font Families
- **Primary**: `ui-sans-serif`

### Custom Fonts Loaded
- **__fkRomanStandard_cfceed** weight 400 (normal)
- **__fkRomanStandard_cfceed** weight 700 (normal)
- **__fkRomanStandard_Fallback_cfceed** weight normal (normal)
- **__manuka_62afb5** weight 900 (normal)
- **__manuka_Fallback_62afb5** weight normal (normal)
- **__polySans_9afc27** weight 300 (normal)
- **__polySans_9afc27** weight 400 (normal)
- **__polySans_9afc27** weight 500 (normal)
- **__polySans_9afc27** weight 700 (normal)
- **__polySans_Fallback_9afc27** weight normal (normal)
- **__polySansMono_0b836e** weight 400 (normal)
- **__polySansMono_0b836e** weight 500 (normal)
- **__polySansMono_0b836e** weight 700 (normal)
- **__polySansMono_Fallback_0b836e** weight normal (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | __polySans_9afc27 | 24px | 700 | 1.1 | 0.24px | Main headline (h2) |
| Input Large | __polySans_9afc27 | 18px | 400 | 1 | normal | Form input (18px) |
| Card Title | ui-sans-serif | 16px | 400 | 1.5 | normal | Card headings |
| Button Small | Courier New | 12px | 600 | 2 | 1.5px | Button label (12px) |
| Button Small | Courier New | 11px | 500 | 1.2 | 1.1px | Button label (11px) |
| Link Small | Courier New | 11px | 400 | 1.18 | 1.1px | Link (11px) — Decoration: none |

### Font Weight Scale

CSS custom properties define 2 explicit weight steps:
- `--coral-sys-global-font-regular-fontWeight`: `400` — Regular
- `--coral-sys-global-font-bold-fontWeight`: `700` — Bold

### Full Font Size Scale

Sizes detected in the design (descending): `90px`, `34px`, `32px`, `26px`, `24px`, `20px`, `19px`, `18px`, `16px`, `15px`, `14px`, `12px`, `11px`

> 8 size(s) detected outside the sampled hierarchy (90px, 34px, 32px, 26px, 20px, 19px, 15px, 14px). 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

**Clone instruction:** Enable these in your CSS:
```css
body {
  font-feature-settings: "tnum";
}
```

## 4. Component Stylings

### Buttons

**Icon Button**
- Background: `transparent`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 0px
- Radius: 0px
- Font: 16px weight 400
- Use: Toolbar/UI icons
- Focus: transform: `none`

**Outline**
- Background: `transparent`
- Text: `#3cffd0` `{colors.primary-focus}`
- Padding: 0px 20px
- Radius: 1px
- Border: 1px solid rgb(60, 255, 208)
- Font: 11px weight 500
- Use: Secondary action with border
- Focus: transform: `none`

**Ghost**
- Background: `transparent`
- Text: `#ffffff` `{colors.hairline}`
- Padding: 14px 0px 14px 14px
- Radius: 0px
- Font: 16px weight 400
- Use: Subtle action, toolbar, nav button
- Focus: transform: `none`

**Pill**
- Background: `#3cffd0` `{colors.primary-focus}`
- Text: `#000000`
- Padding: 10px 24px
- Radius: 24px
- Font: 12px weight 600
- Use: Status pills, tags, chips
- Focus: transform: `none`

**Pill**
- Background: `#313131`
- Text: `#e9e9e9` `{colors.ink-muted}`
- Padding: 10px 24px
- Radius: 24px
- Font: 12px weight 600
- Use: Status pills, tags, chips
- Focus: transform: `none`

**Icon Button**
- Background: `transparent`
- Text: `#000000`
- Padding: 0px
- Radius: 0px
- Font: 16px weight 400
- Use: Toolbar/UI icons
- Focus: transform: `none`

**Ghost**
- Background: `transparent`
- Text: `#000000`
- Padding: 21px
- Radius: 0px
- Font: 16px weight 400
- Use: Subtle action, toolbar, nav button
- Focus: transform: `none`

### Cards & Containers

**Standard Card**
- Background: `transparent`
- Padding: 0px
- Radius: 0px
- Use: Content containers, listing items

### Inputs & Forms

**Text Input**
- Background: `#ffffff` `{colors.hairline}`
- Text: `#000000`
- Padding: 20px 45px 20px 20px
- Radius: 2px
- Border: 0px none rgb(0, 0, 0)
- Font: 18px weight 400
- Use: Text fields, search inputs

### Navigation

**Main Nav**
- Background: `transparent`
- Padding: 8px 0px 0px
- Radius: none
- Font: 16px weight 400
- Use: Fixed/sticky block nav — N/A items

### CTA Banners

**Full-width CTA**
- Background: `transparent`
- Text: `#3cffd0` `{colors.primary-focus}`
- Padding: 0px 20px
- Radius: 1px
- Font: 11px weight 500
- Use: Full-width conversion strip with headline + button
- Focus: transform: `none`

### Tabs

**Ghost Tab**
- Background: `transparent`
- Text: `#000000`
- Padding: 0px
- Radius: 0px
- Font: 16px weight 400
- Use: Navigation tabs, filter tabs

**Pill Tab**
- Background: `#3cffd0` `{colors.primary-focus}`
- Text: `#000000`
- Padding: 10px 24px
- Radius: 24px
- Font: 12px weight 600
- Use: Navigation tabs, filter tabs


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative

- **Link**:
  - **hover:** bg #3cffd0 → #949494, text #000000 → #ffffff, border changes

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

```yaml
component-behaviors:
  button:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(60, 255, 208)"
      border: "1px solid rgb(60, 255, 208)"
    focus:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(60, 255, 208)"
      border: "1px solid rgb(60, 255, 208)"
  input:
    default:
      bg: "rgb(255, 255, 255)"
      fg: "rgb(0, 0, 0)"
  link:
    default:
      bg: "rgb(60, 255, 208)"
      fg: "rgb(0, 0, 0)"
      shadow: "rgba(0, 0, 0, 0) 0px 0px 0px 0px inset"
    hover:
      bg: "rgb(148, 148, 148)"
      fg: "rgb(255, 255, 255)"
      shadow: "rgba(0, 0, 0, 0) 0px 0px 0px 0px inset"
  card:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 0)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(255, 255, 255)"
  tab:
    default:
      bg: "rgb(60, 255, 208)"
      fg: "rgb(0, 0, 0)"
  badge:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 0)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 0)"
```

**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
- **7 shape(s)** in this system: `Icon Button`, `Outline`, `Ghost`, `Pill`, `Pill`
- **DO NOT introduce new buttons variants** without justification

### Cards & Containers
- **1 shape(s)** in this system: `Standard Card`
- **DO NOT introduce new cards & containers variants** without justification

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

### Navigation
- **1 shape(s)** in this system: `Main Nav`
- **DO NOT introduce new navigation variants** without justification

### CTA Banners
- **1 shape(s)** in this system: `Full-width CTA`
- **DO NOT introduce new cta banners variants** without justification

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

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
1300px

### Spacing System
Generous spacing — editorial breathing room

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 4px |
| sm | 8px |
| md | 10px |
| base | 20px |
| lg | 40px |
| xl | 45px |
| 2xl | 70px |
| 3xl | 120px |

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

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `0px` |
| Cards & Containers | `0px` |
| Inputs & Forms | `2px` |
| Navigation | `none` |
| CTA Banners | `1px` |
| Tabs | `0px` |
| Page Body | `0px` |
| Primary Input | `2px` |

**Shape Personality**: Sharp & Angular — No rounding. Precise, editorial, enterprise feel.

**Full Radius Spectrum**: 0px, 1px, 2px, 3px, 24px, 30px (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** | `120px` | Top/bottom of full-bleed hero sections |
| **section** | `45px` | Between major bands (color change, content shift) |
| **subsection** | `40px` | 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).

**4/8 structural patterns detected.**

### Card Grid Pattern

- **Card count:** 12 cards detected
- **Columns (desktop):** 2-up grid
- **Card dimensions:** 928×332px (aspect 2.79:1)
- **Gap:** 130px between cards
- **Content:** ✓ image + CTA
- **Image position:** top
- **Clone instruction:** Build a 2-column grid (desktop) with cards at ~2.79:1 aspect ratio. Each card has an image at the top.

### Pricing Table Pattern

- **Tier count:** 2 pricing tiers
- **Layout:** vertical stacked
- **Columns (desktop):** 2-up
- **Clone instruction:** Build a 2-column vertical-stack pricing comparison.

### Testimonial Pattern

- **Count:** 3 testimonial blocks
- **Layout:** list
- **Avg quote length:** 245 chars (long-form story)
- **Includes:** ✗ no avatars | ✗ no logos | ✗ no ratings
- **Clone instruction:** Build a list of 3 testimonials.   

### Footer Pattern

- **Columns:** 1
- **Links:** 20 total
- **Height:** 629px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 1-column footer with ~20 links per column, social media links, and a copyright line.

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |
| Inset (Level 1) | <br>`rgba(0, 0, 0, 0) 0px 0px 0px 0px inset` | Buttons, pressed-state elements |
| Layered (Level 2) | <br>`rgba(0, 0, 0, 0.4) 0px 4px 10px 0px` | Cards, elevated surfaces |
| Inset (Level 3) | <br>`rgb(255, 255, 255) 0px -1px 0px 0px inset` | Buttons, pressed-state elements |
| Inset (Level 4) | <br>`rgba(0, 0, 0, 0) 0px -1px 0px 0px inset` | Buttons, pressed-state elements |

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

## 7. Motion & Interaction

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `ftptba1` | Rotate / Spin | transform | UI transition |
| `lk710f0` | Slide | transform | UI transition |
| `lk710f1` | Slide | transform | UI transition |
| `lk710f2` | Slide | transform | UI transition |
| `lk710f3` | Slide | transform | UI transition |
| `_4zezgs1` | Fade + Move | opacity, transform | UI transition |
| `fqbi2x0` | Fade | opacity | UI transition |
| `_1ra7jrq0` | Fade + Move | opacity, transform | UI transition |
| `pswp-clockwise` | Rotate / Spin | transform | UI transition |
| `_1ds4jca0` | Fade | opacity | UI transition |
| `_1ds4jca4` | Rotate / Spin | transform | UI transition |
| `onetrust-fade-in` | Fade | opacity | Element entrance |
| `ot-slide-in-left` | Slide | transform | Panel / drawer enter |
| `ot-slide-in-right` | Slide | transform | Panel / drawer enter |
| `ot-slide-out-left` | Slide | transform | Panel / drawer exit |
| `ot-slide-out-right` | Slide | transform | Panel / drawer exit |
| `slide-down-custom` | Custom | bottom | Panel / drawer enter |

### Motion Fingerprint

- **Dominant Easing**: standard CSS easings
- **Animation Library**: 17 unique animations (17 total including variants)

## 8. Do's and Don'ts

### Do
- Use dark background (`#131313`) as the foundation — this is a dark-mode-native design
- Use ui-sans-serif as the primary typeface — it defines the brand personality
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use #3cffd0 (`#3cffd0`) as the primary accent — it's the brand's signature interactive color
- Use 24px border-radius on primary buttons — the brand uses generously-rounded CTAs
- Respect the 4px–45px spacing range — the design uses a wide scale for visual breathing room
- Each card includes a top image — imagery is part of the card identity, not optional

### Don't
- Don't use light backgrounds — the dark canvas is the native medium
- Don't substitute with generic sans-serif or serif — the custom font carries the brand
- 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 sharp-cornered or pill buttons — 24px is the CTA border-radius standard


## 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(19, 19, 19)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(19, 19, 19)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `#3cffd0` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"#3cffd0\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 320px | Single column, compact spacing |
| Mobile | 400px | Single column, compact spacing |
| Mobile Large | 530px | Expanded mobile layout |
| Mobile Large | 767px | Expanded mobile layout |
| Tablet | 1023px | Multi-column grids begin |
| Desktop | 1280px | Full feature layout |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| nav | height | `37px` | `auto` |
| button | width | `20px` | `auto` |
| card | width | `680px` | `370px` |
| main | max-width | `1300px` | `600px` |

### Collapsing Strategy
- 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: 0px 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):

- **Card grid: 2-up → 1-up** — cards stack as viewport narrows, becoming a vertical list on mobile.

## 9b. Visual Tone & Photography

**Tone:** Photography-driven

The site is dominated by photography (JPG/WebP). Photos carry the brand voice as much as the typography. Use authentic, brand-appropriate imagery — generic stock will degrade quality.

**Canonical Brand Image (OG):**
- https://platform.theverge.com/wp-content/uploads/sites/2/2024/10/the_verge_social_share.png
  *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: 1.25:1 (landscape)
- Rendered size: 680×544px
- Alt text: "AI grifters are creating fake Black people to sell Shein junk"
- *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 (17%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 38 (83%)

**Media Format Mix:**
- JPG: 30 (typically photographic content)
- WebP: 2 (optimized photo/illustration hybrid)
- PNG: 14 (logos, transparent UI elements, mockups)
- SVG: 1 (icons, illustrations, decorative geometry)

**Average rendered image size:** 161×138px
**Above-fold image count:** 1 / 46

**Decorative Patterns Detected:**
- 1 large decorative SVG shape (≥200×200px, non-icon) — likely blob/illustration accents
- 16 background patterns (non-photo url() backgrounds) — textures/illustrations as backdrops

**Clone instruction for decorative work:** Decorative details are subtle — don't over-style; the design relies on restraint.

**Imagery Guidance for clones:**
- Source authentic photography (or licensed stock that matches the brand mood) — placeholders will visibly degrade the clone.
- Match the dominant aspect ratio (see above) so card grids and hero compositions hold.

## 10. Agent Prompt Guide

### Quick Reference
- Background: Jet Black (`#131313`)
- Primary text: Pure Black (`#000000`)
- Accent: #3cffd0 (`#3cffd0`)
- Border: Translucent Pure White (8%) (`rgba(255, 255, 255, 0.08)`)
- Font: ui-sans-serif
- Body: 16px weight 400

### Example Component Prompts
- "Create the primary CTA button: `#3cffd0` background, `#000000` text, 24px border-radius, 10px 24px padding, 600 weight, ui-sans-serif font."
- "Design a card on `transparent` background. Border: none. Radius: 0px. Shadow: none. Padding: 0px."
- "Build navigation: absolute on `#131313`. ui-sans-serif 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the dark canvas to Jet Black (`#131313`) — every component is composited against this exact base.
2. **Typography**: All type in ui-sans-serif, weight range 400–700. Never exceed 700 — heavier weights break the brand's tonal restraint.
3. **Accent**: #3cffd0 (`#3cffd0`) is the sole interactive color. On hover → #3cffd0 (`#3cffd0`). Use CSS transitions, not opacity/brightness filters.
4. **Shape**: CTAs at `1px`, cards at `0px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
5. **Spacing**: Use the `--ca-space-*` token scale (4px–45px). All padding, margin, and gap values are multiples from this scale — no magic numbers.
6. **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-1: #131313;
  --ca-surface-2: #222222;
  --ca-ink-muted: #e9e9e9;
  --ca-ink-subtle: #949494;
  --ca-primary-focus: #3cffd0;
  --ca-hairline: #ffffff;
}

/* Typography */
:root {
  --ca-font-primary: "__polySans_9afc27", system-ui, sans-serif;
  --ca-text-display: 24px;
  --ca-text-body: 16px;
  --ca-text-small: 11px;
  --ca-text-button: 12px;
  --ca-text-mono: 18px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 4px;
  --ca-space-sm: 8px;
  --ca-space-md: 10px;
  --ca-space-base: 20px;
  --ca-space-lg: 40px;
  --ca-space-xl: 45px;
  --ca-space-2xl: 70px;
  --ca-space-3xl: 120px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 3px;
  --ca-radius-sm: 3px;
  --ca-radius-md: 24px;
  --ca-radius-lg: 24px;
  --ca-radius-xl: 30px;
  --ca-radius-full: 9999px;
}
```


## 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: unknown
    tag: div
    height: 10538px
    width: full-bleed
    layout: block
    children: 3
  - section: unknown
    tag: div
    classes: ["m-ad", "prelude"]
    height: 250px
    width: full-bleed
    layout: block
    children: 1
  - section: main-content
    tag: main
    height: 9579px
    width: 1300px
    layout: block
    children: 6
    padding: "10px 0px 40px"
  - section: hero
    tag: div
    classes: ["duet--homepage--hero"]
    height: 1126px
    width: 800px
    layout: block
    children: 2
  - section: unknown
    tag: div
    classes: ["duet--layout--river", "x96f282", "x96f281", "duet--layout--river-container"]
    height: 14608px
    width: 380px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 601px
    width: 380px
    layout: block
    children: 2
  - section: hero
    tag: div
    classes: ["m-ad"]
    height: 150px
    width: 800px
    layout: block
    children: 1
    padding: "35px 0px 25px"
  - section: section-13
    tag: section
    classes: ["duet--homepage-top-curated-content-section-0"]
    height: 614px
    width: 800px
    layout: flex-column justify=normal
    children: 2
  - section: unknown
    tag: div
    classes: ["m-ad", "dfp_ad--pb-50"]
    height: 335px
    width: 380px
    layout: block
    children: 1
    padding: "35px 0px 50px"
  - section: section-14
    tag: section
    classes: ["duet--homepage-top-curated-content-section-1"]
    height: 644px
    width: 800px
    layout: flex-column justify=normal
    children: 2
  - section: unknown
    tag: div
    classes: ["m-ad"]
    height: 90px
    width: 800px
    layout: block
    children: 1
  - section: section-15
    tag: section
    classes: ["pnbklw0", "duet--homepage--most-popular"]
    height: 498px
    width: 800px
    layout: flex-column justify=normal
    children: 2
    padding: "8px 0px 0px"
  - section: section-16
    tag: section
    classes: ["duet--homepage-bottom-curated-content-section-0"]
    height: 681px
    width: 800px
    layout: flex-column justify=normal
    children: 2
  - section: unknown
    tag: div
    classes: ["m-ad", "dfp_ad--pb-50"]
    height: 335px
    width: 380px
    layout: block
    children: 1
    padding: "35px 0px 50px"
  - section: section-17
    tag: section
    classes: ["duet--homepage-bottom-curated-content-section-1"]
    height: 684px
    width: 800px
    layout: flex-column justify=normal
    children: 2
  - section: section-18
    tag: section
    classes: ["pnbklw0", "duet--homepage--most-discussed"]
    height: 481px
    width: 800px
    layout: flex-column justify=normal
    children: 2
    padding: "8px 0px 0px"
  - section: section-20
    tag: section
    classes: ["duet--homepage--category-shelf"]
    height: 339px
    width: 928px
    layout: flex-column justify=normal
    children: 2
  - section: unknown
    tag: div
    classes: ["duet--homepage-category-shelves-rail-section"]
    height: 1480px
    width: 300px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["duet--homepage-category-shelves-container"]
    height: 2960px
    width: 1300px
    layout: flex-row justify=normal
    children: 2
    padding: "0px 16px"
  - section: section-21
    tag: section
    classes: ["duet--homepage--category-shelf"]
    height: 339px
    width: 928px
    layout: flex-column justify=normal
    children: 2
  - section: section-22
    tag: section
    classes: ["duet--homepage--category-shelf"]
    height: 319px
    width: 928px
    layout: flex-column justify=normal
    children: 2
  - section: unknown
    tag: div
    classes: ["duet--homepage-category-shelves-rail-section"]
    height: 1480px
    width: 300px
    layout: block
    children: 1
  - section: section-23
    tag: section
    classes: ["duet--homepage--category-shelf"]
    height: 339px
    width: 928px
    layout: flex-column justify=normal
    children: 2
  - section: section-19
    tag: section
    classes: ["xnv72h0"]
    height: 280px
    width: 380px
    layout: block
    children: 3
  - section: section-24
    tag: section
    classes: ["duet--homepage--category-shelf"]
    height: 359px
    width: 928px
    layout: flex-column justify=normal
    children: 2
```

**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:
    - "Weekend reads / Catch up on our favorite stories of the week."
    - "Most Popular"
    - "Feedback loop / Company ambitions don’t always line up with customer satisfaction."
  ctas:
    - "SKIP TO MAIN CONTENT"
    - "LATEST"
    - "FOLLOWING"
  navigation:
    - "Tech"
    - "Reviews"
    - "Science"
    - "Entertainment"
    - "AI"
    - "Policy"
    - "Amazon"
    - "Apple"
    - "Facebook"
    - "Google"
  footer-links:
    - "Contact"
    - "Terms of Use"
    - "VOX MEDIA"
```

**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: 4
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "The golden age of handheld gaming is already over"
      - "How Ferrari bungled the design of its first EV"
      - "This is the James Bond game we’ve been waiting for"
  thumbnail:
    count: 21
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "Welcome to Night Vale host Cecil Baldwin shares his tech pet"
      - "The SpaceX IPO is great for Elon Musk and terrible for you"
      - "The Arduboy FX-C is an excellent time killer you might forge"
```

**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">
  SKIP TO MAIN CONTENT
</button>
```
_Source pattern detected: padding `0px 20px` · radius `1px` · weight `500`_

### Generic Card
```html
<div class="card">
  <!-- content -->
</div>
```
_Source pattern detected: padding `0px` · radius `0px` · shadow `none`_

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


## 12. Known Extraction Gaps

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

- **1 parasitic shadow(s) detected** — colored box-shadows (not near-black) found in allShadows. These likely originate from browser extensions or third-party injected widgets (e.g. Grammarly, chat overlays), not from the site's own design system. Discard them when building.


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

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 14 | 25 | 10 named colors |
| Typography | 15 | 20 | 6 roles defined |
| Components | 20 | 20 | 6 specs extracted |
| Motion & Interaction | 10 | 15 | Keyframes present |
| CSS Custom Properties | 10 | 10 | 1898 vars |
| Responsive Breakpoints | 5 | 5 | 6 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.

| Category | What's missing | Fallback strategy |
|----------|----------------|-------------------|
| **Dark mode** | No dark-mode CSS variables or media queries detected | Light mode is canonical; do not generate dark-mode variants unless explicitly requested |

### Per-section confidence

| Section | Confidence | Reason |
|---------|------------|--------|
| §1 Visual Theme | High | Body bg extracted via getComputedStyle() |
| §2 Colors | High | 1898 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 6 typography roles inferred |
| §4 Components | High | 6 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 | 6 breakpoints detected |
| §9b Photography | High | 46 images, hero present |

---
*Generated by Clone Architect — automated Playwright extraction + design analysis.*
*Source: https://theverge.com | 2026-05-30T20:40:10.408Z*
*All values verified via getComputedStyle() — no approximation, no hallucination.*