headspace.com

DESIGN.md

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

---
version: alpha
name: headspace.com
description: "Light product system built on #ffffff with #0061ef as the primary CTA accent. Type anchored in Headspace Apercu at 52px / weight 700. Extracted automatically from https://headspace.com/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
narrative: |
  headspace.com is built on a pure-white canvas (rgb(255, 255, 255)).
  The system uses rgb(0, 97, 239) as the high-saturation accent for primary actions.
  Moderately rounded CTAs (8px) — modern SaaS standard, neither sharp nor pill alongside Headspace Apercu as the primary typeface.
  A restrained elevation system (2 distinct shadows) — shadows reserved for the few elements that must lift off the page.
  Motion is minimal — a few targeted transitions, no decorative animation.

colors:
  background: "#ffffff"
  surface-1: "#f9f4f2"
  surface-2: "#eae7e4"
  ink: "#4b4c4d"
  ink-muted: "rgba(75, 76, 77, 0.65)"
  ink-subtle: "rgba(138, 139, 139, 0.62)"
  primary: "#0061ef"
  on-primary: "#ffffff"
  primary-hover: "#ffce00"
  hairline: "#4b4c4d"

typography:
  display-xl:
    fontFamily: "Headspace Apercu, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 64px
    fontWeight: 700
    lineHeight: 1
    letterSpacing: -1.92px
  display-lg:
    fontFamily: "Headspace Apercu, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 52px
    fontWeight: 700
    lineHeight: 1.1
    letterSpacing: -1.56px
  display-md:
    fontFamily: "Headspace Apercu, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 40px
    fontWeight: 700
    lineHeight: 1.15
    letterSpacing: -1.2px
  headline:
    fontFamily: "Headspace Apercu, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 32px
    fontWeight: 700
    lineHeight: 1.2
    letterSpacing: -0.96px
  body:
    fontFamily: "Headspace Apercu, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.15
    letterSpacing: 0
  body-sm:
    fontFamily: "Headspace Apercu, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 500
    lineHeight: 1.38
    letterSpacing: -0.16px
  button:
    fontFamily: "Headspace Apercu, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 18px
    fontWeight: 700
    lineHeight: 1.2
    letterSpacing: -0.54px

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

spacing:
  xxs: 2px
  xs: 8px
  sm: 10px
  md: 16px
  lg: 24px
  xl: 32px
  xxl: 64px

components:
  button-ghost:
    backgroundColor: "transparent"
    textColor: "#44423f"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
  button-light--invert:
    backgroundColor: "{colors.on-primary}"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.xs}"
    padding: 8px 16px 8px 24px
  button-pill:
    backgroundColor: "#2d2c2b"
    textColor: "{colors.on-primary}"
    typography: "{typography.button}"
    rounded: "{rounded.lg}"
    padding: 0px 24px
  input-text-input:
    backgroundColor: "{colors.on-primary}"
    textColor: "#000000"
    typography: "{typography.body}"
    rounded: "{rounded.xs}"
    padding: 24px 16px 8px
  navigation-main-nav:
    backgroundColor: "{colors.on-primary}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 0px 48px

extracted_at: "2026-06-14T15:13:33.813Z"
completeness: 74
scoreVersion: "v2"

---

# Design System — headspace.com
> Extracted automatically by Prism from https://www.headspace.com
> Date: 2026-06-14
> 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).


## 0. Design DNA

**Density**: moderate  |  **Motion**: subtle  |  **Weight**: heavy  |  **Aesthetic**: soft-rounded

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#ffffff` |
| Type posture | sans-led (Headspace Apercu) | "Improve relationships" |
| Color assertion | dual-accent | #0061ef |
| Whitespace | moderate | section rhythm 48px |
| Interaction | subtle | 2 keyframes, 4 transitions |
| Radius language | soft-pill | from token scale |

**Prism fingerprint**: `neutral-canvas · sans-display · dual-accent · soft-pill · 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(0, 97, 239)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 48px between major bands. Card padding: 24px.
> - **Default radius**: 12px 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

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

Typography is anchored in **Headspace Apercu**. Headlines use weight 700 for confident, assertive presence — the brand wants to be heard. Negative letter-spacing at display sizes (-1.56px at 52px) compresses headlines into engineered blocks, dense and precise. 

Body text reads in Charcoal (`#4b4c4d`). **#0061ef** (`#0061ef`) 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 comes from a small, deliberate set of shadows (2 distinct), each a multi-layer stack — several blurred layers at varying offsets — used sparingly rather than across the whole UI. 
Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: Pure White (`#ffffff`)
- Primary typeface: Headspace Apercu
- Primary text: Charcoal (`#4b4c4d`)
- Accent: #0061ef (`#0061ef`)
- Display: 52px weight 700, letter-spacing -1.56px
- Shadow system: 2 distinct elevation levels
- Custom fonts loaded: Headspace Apercu, Apercu Pro Mono

## 2. Color Palette & Roles

### Background & Surface
- **Pure White** (`#ffffff`): Page background (primary)
- **Off-White** (`#f9f4f2`): Surface / elevated background
- **Whitesmoke** (`#e2ded9`): Surface / elevated background
- **Whitesmoke** (`#eae7e4`): Surface / elevated background
- **Off-White** (`#faf6f4`): Surface / elevated background

### Text & Content
- **Charcoal** (`#4b4c4d`): Primary body text
- **Pure Black** (`#000000`): Secondary text
- **Charcoal** (`#2d2c2b`): Secondary text
- **#0000ee** (`#0000ee`): Secondary text
- **Near-Black** (`#141313`): Secondary text

### Accent & Interactive
- **#0061ef** (`#0061ef`): Interactive / accent
- **Gold** (`#ffce00`): Interactive / accent
- **#ad85d1** (`#ad85d1`): Interactive / accent
- **#ffa1cc** (`#ffa1cc`): Interactive / accent
- **Sky Bright** (`#00a4ff`): Interactive / accent
- **#ff9900** (`#ff9900`): Interactive / accent
- **#ff7300** (`#ff7300`): Interactive / accent

### Border & Divider
- **#d2d5de** (`#d2d5de`): Borders / dividers

### Full Extracted Palette
**38 colors rendered on the page**. (18 categorized above + 20 additional below.)
Rendered values are read via `getComputedStyle()`; token values come from CSS variable declarations. Third-party logo colors are filtered out.

- `#44423f` — Charcoal
- `#63605d` — Slate Grey
- `#9d968e` — Cool Gray
- `#3b197f` — #3b197f
- `#8144a8` — #8144a8
- `#1a0c54` — #1a0c54
- `#ff76b8` — Hot Pink
- `#5f2b89` — #5f2b89
- `#9e65c6` — Amethyst
- `#281466` — #281466
- `#0040ea` — #0040ea
- `#101340` — Navy Blue
- `#0b662a` — #0b662a
- `#ffb700` — Amber
- `#613889` — #613889
- `#02873e` — #02873e
- `#8251a8` — #8251a8
- `#1a1919` — Near-Black
- `#fc5500` — Bright Orange
- `#ffe14f` — #ffe14f

## 3. Typography Rules

### Font Families
- **Primary**: `Headspace Apercu`
- **Secondary**: `Apercu Pro Mono`

### Custom Fonts Loaded
- **Headspace Apercu** weight 400
- **Headspace Apercu** weight 600
- **Headspace Apercu** weight 200
- **Headspace Apercu** weight 700
- **Apercu Pro Mono** weight 700
- **Apercu Pro Mono** weight 200
- **Apercu Pro Mono** weight 600
- **Apercu Pro Mono** weight 400

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Headspace Apercu | 64px | 700 | 1 | -1.92px | Main headline (h2) |
| Section Heading | Headspace Apercu | 52px | 700 | 1.1 | -1.56px | Section titles (div) |
| Sub-heading | Headspace Apercu | 40px | 700 | 1.15 | -1.2px | Third-level heading (h3) |
| Label Heading | Headspace Apercu | 32px | 700 | 1.2 | -0.96px | Small heading (H5) |
| Label Heading | Headspace Apercu | 24px | 700 | 1.33 | -0.6px | Small heading (H4) |
| Button Large | Headspace Apercu | 18px | 700 | 1.2 | -0.54px | Button label (18px) |
| Body | Headspace Apercu | 16px | 400 | 1.15 | normal | Standard reading text |
| Button Large | Headspace Apercu | 16px | 700 | 1.1 | normal | Button label (16px) |
| Link Large | Headspace Apercu | 16px | 500 | 1.38 | -0.16px | Link (16px) — Decoration: none |

### Full Font Size Scale

Sizes detected in the design (descending): `64px`, `52px`, `48px`, `40px`, `32px`, `24px`, `20px`, `18px`, `16.52px`, `16px`, `14px`, `12px`

> 5 size(s) detected outside the sampled hierarchy (48px, 20px, 16.5186px, 14px, 12px). These appear on elements not in the sampled set — likely additional display sizes, marketing-section overrides, or third-party-widget styles.

## 4. Component Stylings

### Buttons

**Ghost**
- Background: `transparent`
- Text: `#44423f`
- Padding: 0px
- Radius: 0px
- Border: 2px solid rgba(0, 0, 0, 0)
- Font: 16px weight 700
- Use: Subtle action, toolbar, nav button

**Light / Invert**
- Background: `#ffffff` `{colors.on-primary}`
- Text: `#4b4c4d` `{colors.hairline}`
- Padding: 8px 16px 8px 24px
- Radius: 8px
- Border: 2px solid rgb(226, 222, 217)
- Font: 16px weight 400
- Use: Bright CTA on dark sections

**Pill**
- Background: `#2d2c2b`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 0px 24px
- Radius: 24px
- Font: 18px weight 700
- Use: Status pills, tags, chips

**Pill**
- Background: `#f9f4f2` `{colors.surface-1}`
- Text: `#2d2c2b`
- Padding: 0px 24px
- Radius: 24px
- Font: 18px weight 700
- Use: Status pills, tags, chips

**Secondary**
- Background: `#2d2c2b`
- Text: `#ffffff` `{colors.on-primary}`
- Padding: 10px
- Radius: 50%
- Border: 2px solid rgba(0, 0, 0, 0)
- Font: 24px weight 700
- Use: Secondary action

**Light / Invert**
- Background: `#f9f4f2` `{colors.surface-1}`
- Text: `#44423f`
- Padding: 10px
- Radius: 50%
- Border: 2px solid rgba(0, 0, 0, 0)
- Font: 24px weight 700
- Use: Bright CTA on dark sections

### Inputs & Forms

**Text Input**
- Background: `#ffffff` `{colors.on-primary}`
- Text: `#000000`
- Padding: 24px 16px 8px
- Radius: 8px
- Border: 1px solid rgb(210, 213, 222)
- Font: 16px weight 400
- Use: Text fields, search inputs
- Focus: outline: `rgb(16, 16, 16) auto 1px`

### Navigation

**Main Nav**
- Background: `#ffffff` `{colors.on-primary}`
- Padding: 0px 48px
- Radius: none
- Font: 16px weight 400
- Use: Static block nav — N/A items


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative


*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(68, 66, 63)"
      border: "2px solid rgba(0, 0, 0, 0)"
  input:
    default:
      bg: "rgb(255, 255, 255)"
      fg: "rgb(0, 0, 0)"
      border: "1px solid rgb(210, 213, 222)"
    focus:
      bg: "transparent"
      fg: "inherit"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(45, 44, 43)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 238)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(68, 66, 63)"
    hover:
      bg: "transparent"
      fg: "inherit"
```

**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
- **4 shape(s)** in this system: `Ghost`, `Light / Invert`, `Pill`, `Secondary`
- **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

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

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
1360px

### Spacing System
Compact spacing — information density prioritized

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 8px |
| sm | 10px |
| md | 16px |
| base | 20px |
| lg | 24px |
| xl | 32px |
| 2xl | 48px |
| 3xl | 64px |

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

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `0px` |
| Inputs & Forms | `8px` |
| Navigation | `none` |
| Page Body | `0px` |
| Primary Input | `8px` |

**Shape Personality**: Moderate Rounding — Medium corners (4–12px). Modern SaaS standard, neither sharp nor pill.

**Full Radius Spectrum**: 0px, 8px, 12px, 16px, 24px, 32px, 800px (from `allBorderRadii` scan)


## 5b. Spacing Rhythm Names

**Measured section padding**: bands use ~80px internal vertical padding (up to 96px) — **generous**. (Distinct from the gap *between* sections above.) Reproduce this generous vertical breathing room; cramped spacing is the #1 tell of a cheap clone.

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

| Name | Value | Use case |
|------|-------|----------|
| **hero** | `64px` | Top/bottom of full-bleed hero sections |
| **section** | `32px` | Between major bands (color change, content shift) |
| **subsection** | `24px` | Within a section, between content groups |
| **card** | `16px` | Card padding, list-item spacing |
| **compact** | `10px` | Form fields, tight clusters, badge padding |
| **micro** | `8px` | 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).

**6/8 structural patterns detected.**

### Navigation Pattern

- **Position:** static (scrolls with page)
- **Layout:** unknown — Layout not classified
- **Height:** 80px
- **Logo:** ✓ present
- **Nav links:** 6 primary items
- **CTAs in nav:** 0 (no buttons — links only)
- **Clone instruction:** Build a static unknown navigation. Link-only — no button styling needed.

### Card Grid Pattern

- **Card count:** 5 cards detected
- **Columns (desktop):** 1-up grid
- **Card dimensions:** 1344×590px (aspect 2.28:1)
- **Gap:** 24px between cards
- **Content:** ✗ no image + icon + CTA
- **Clone instruction:** Build a 1-column grid (desktop) with cards at ~2.28:1 aspect ratio. Text/icon-only cards (no photography).

### Pricing Table Pattern

- **Tier count:** 2 pricing tiers
- **Layout:** side-by-side (horizontal comparison)
- **Columns (desktop):** 2-up
- **Feature list:** ✓ (median ~50 feature points per tier)
- **Clone instruction:** Build a 2-column side-by-side pricing comparison.

### Testimonial Pattern

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

### FAQ Pattern

- **Item count:** 8 questions
- **Format:** accordion (expand/collapse)
- **Layout:** single-column
- **Avg question length:** 38 chars
- **Clone instruction:** Build 8 expandable accordion items in a single-column layout.

### Footer Pattern

- **Columns:** 2
- **Links:** 47 total
- **Height:** 534px
- **Includes:** ✗ no newsletter | ✗ no social |  
- **Clone instruction:** Build a 2-column footer with ~24 links per column.

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |
| Layered (Level 1) | <br>`rgba(20, 19, 19, 0.2) 0px 1px 8px 0px` | Cards, elevated surfaces |
| Layered (Level 2) | <br>`rgba(65, 61, 69, 0.2) 0px 2px 0px 0px` | Cards, elevated surfaces |

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

## 7. Motion & Interaction

### Dominant Easing Curves

| Curve | Semantic Name |
|-------|---------------|
| `cubic-bezier(0.32,0.94,0.6,1)` | Custom Ease — Balanced |

### Duration Scale

| Value | Tier | Typical Use |
|-------|------|-------------|
| `150ms` | Fast | Hover states, micro-interactions |
| `300ms` | Normal | Panel open/close, navigation |

### Copy-Paste Transition Snippets

**Color / Background**
```css
transition: color 0.15s cubic-bezier(0.32, 0.94, 0.6, 1), background-color 0.15s cubic-bezier(0.32, 0.94, 0.6, 1), border-color 0...;
```

**Border**
```css
transition: border 0.3s;
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `onetrust-fade-in` | Fade | opacity | Element entrance |
| `slide-down-custom` | Custom | bottom | Panel / drawer enter |

### Motion Fingerprint

- **Speed Character**: Deliberate & Calm (median duration: `300ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 2 unique animations (2 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 Headspace Apercu as the primary typeface — it defines the brand personality
- Use negative letter-spacing (-1.56px) at display sizes for compressed, editorial headlines
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use #0061ef (`#0061ef`) 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
- Style form inputs with a `1px solid rgb(210, 213, 222)` border — use border-based inputs, not floating labels or underline-only
- Maintain nav height at 80px — consistent vertical space for the navigation bar
- Each card uses an icon (not photo) — the visual language is illustrative, not photographic
- Place 2 pricing tiers side-by-side on desktop — direct comparison is the value prop
- Use expandable accordion for the FAQ — saves vertical space and lets users self-navigate

### 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 remove the input border — the border is the primary affordance indicator for form fields
- Don't collapse or hide the nav on scroll without an explicit scroll-triggered animation — the design uses fixed nav presence
- Don't make the nav sticky — this design lets it scroll away to maximize content focus
- Don't put a CTA button in the nav — this design uses links only at the top


## 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(0, 97, 239)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(0, 97, 239)\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

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

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `52px` | `36px` |
| heading | line-height | `57.2px` | `36px` |
| heading | letter-spacing | `-1.56px` | `-1.08px` |
| nav | height | `80px` | `64px` |
| button | width | `auto` | `28px` |

### Collapsing Strategy
- Headlines: 52px → 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: 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):

- **Pricing collapses to vertical stack** — desktop comparison becomes scrollable tier-by-tier on 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 (10)

## 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://images.ctfassets.net/v3n26e09qg2r/4NcF0eXixKLYQFKIQ0pXWV/802a953e11a4f70ef3c5aaf8df27dbfc/Headspace_Opengraph.png (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: 2.04:1 (landscape (16:9-ish))
- Rendered size: 598×293px
- Alt text: "desktop hero 1 june5 2x 1 copy"
- *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): 18 (33%)
- Portrait (<0.87): 14 (26%)
- Square (0.87–1.15): 16 (30%)
- Ultra-wide (>2.3): 6 (11%)

**Media Format Mix:**
- WebP: 22 (optimized photo/illustration hybrid)
- SVG: 35 (icons, illustrations, decorative geometry)

**Average rendered image size:** 303×237px
**Above-fold image count:** 14 / 54

**Decorative Patterns Detected:**
- 3 large decorative SVG shapes (≥200×200px, non-icon) — likely blob/illustration accents

**Clone instruction for decorative work:** Decorative SVG accents are part of the brand — generate or source blob/illustration shapes to scatter behind content.

**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: Pure White (`#ffffff`)
- Primary text: Charcoal (`#4b4c4d`)
- Accent: #0061ef (`#0061ef`)
- Border: Charcoal (`#4b4c4d`)
- Font: Headspace Apercu
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Pure White background (#ffffff). Headline at 52px Headspace Apercu weight 700, line-height 1.1, letter-spacing -1.56px, color #4b4c4d."
- "Create the primary CTA button: `#0061ef` background, `#44423f` text, 9999px border-radius, 12px 24px padding, 700 weight, Headspace Apercu font."
- "Build navigation: static on `#ffffff`. Headspace Apercu 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Pure White (`#ffffff`) — every component is composited against this exact base.
2. **Typography**: All type in Headspace Apercu, weight range 400–700. Never exceed 700 — heavier weights break the brand's tonal restraint.
3. **Accent**: #0061ef (`#0061ef`) — one accent, applied consistently to CTAs, active states, and links. Never introduce a second saturated color.
4. **Motion**: All transitions use `cubic-bezier(0.32,0.94,0.6,1)`. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `8px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (8px–32px). 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-on-primary: #ffffff;
  --ca-surface-1: #f9f4f2;
  --ca-surface-2: #eae7e4;
  --ca-hairline: #4b4c4d;
  --ca-ink-subtle: #8a8b8b;
  --ca-primary: #0061ef;
  --ca-primary-hover: #ffce00;
}

/* Typography */
:root {
  --ca-font-primary: "Headspace Apercu", system-ui, sans-serif;
  --ca-text-display: 64px;
  --ca-text-heading: 52px;
  --ca-text-body: 16px;
  --ca-text-small: 16px;
  --ca-text-button: 18px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 8px;
  --ca-space-sm: 10px;
  --ca-space-md: 16px;
  --ca-space-base: 20px;
  --ca-space-lg: 24px;
  --ca-space-xl: 32px;
  --ca-space-2xl: 48px;
  --ca-space-3xl: 64px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 8px;
  --ca-radius-sm: 12px;
  --ca-radius-md: 16px;
  --ca-radius-lg: 24px;
  --ca-radius-xl: 32px;
  --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: hero
    tag: div
    height: 8714px
    width: full-bleed
    layout: block
    children: 1
  - section: feature-section
    tag: main
    height: 8714px
    width: full-bleed
    layout: block
    children: 1
  - section: logo-strip
    tag: div
    height: 80px
    width: full-bleed
    layout: block
    children: 1
  - section: header
    tag: header
    height: 80px
    width: full-bleed
    layout: flex-row justify=space-between
    children: 2
    bg: "rgb(255, 255, 255)"
    padding: "0px 48px"
  - section: navigation
    tag: nav
    height: 80px
    width: 520px
    layout: block
    children: 1
  - section: hero
    tag: div
    height: 708px
    width: 1380px
    layout: flex-column justify=normal
    children: 2
    padding: "0px 24px 20px"
  - section: feature-section
    tag: div
    height: 473px
    width: full-bleed
    layout: block
    children: 2
    vertical-padding: ~96px (airy)
    padding: "64px 48px 128px"
  - section: feature-section
    tag: div
    height: 956px
    width: full-bleed
    layout: flex-column justify=normal
    children: 4
    vertical-padding: ~48px
    padding: "64px 48px 32px"
  - section: feature-section
    tag: div
    height: 1035px
    width: full-bleed
    layout: flex-column justify=normal
    children: 2
    vertical-padding: ~80px (generous)
    padding: "64px 48px 96px"
  - section: feature-section
    tag: div
    height: 978px
    width: full-bleed
    layout: flex-row justify=space-between
    children: 1
    vertical-padding: ~88px (generous)
    padding: "48px 48px 128px"
  - section: content-section
    tag: div
    height: 134px
    width: full-bleed
    layout: flex-row justify=space-between
    children: 1
    vertical-padding: ~24px
    padding: "0px 0px 48px"
  - section: feature-section
    tag: div
    height: 790px
    width: full-bleed
    layout: block
    children: 4
    vertical-padding: ~48px
    padding: "64px 48px 32px"
  - section: feature-section
    tag: div
    height: 830px
    width: full-bleed
    layout: block
    children: 1
    vertical-padding: ~56px (generous)
    padding: "80px 48px 32px"
  - section: feature-section
    tag: div
    height: 892px
    width: 1160px
    layout: flex-column justify=normal
    children: 3
    vertical-padding: ~88px (generous)
    padding: "80px 0px 96px"
  - section: section
    tag: section
    height: 784px
    width: full-bleed
    layout: block
    children: 1
  - section: content-section
    tag: div
    height: 916px
    width: full-bleed
    layout: block
    children: 3
    vertical-padding: ~48px
    padding: "96px 0px 0px"
  - section: section
    tag: section
    height: 494px
    width: 220px
    layout: block
    children: 2
  - section: footer
    tag: footer
    height: 534px
    width: 1360px
    layout: flex-row justify=normal
    children: 2
    padding: "0px 0px 40px"
  - section: logo-strip
    tag: section
    height: 100px
    width: full-bleed
    layout: flex-row justify=space-between
    children: 2
    vertical-padding: ~24px
    padding: "24px 32px"
```

**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:
    - "all with Headspace"
    - "What kind of headspace are you looking for?"
    - "The mental health app for every moment"
    - "Members are enjoying happier and healthier lives"
    - "Over 4,000 leading organizations choose Headspace"
    - "Explore our library"
  sub-headings:
    - "Always-there support"
    - "Feel-good library"
    - "Bedtime essentials"
    - "Do-anywhere exercises"
  ctas:
    - "Stress less"
    - "AI guidance"
    - "Guided meditations"
    - "Featured"
    - "Popular"
  navigation:
    - "For You"
    - "For Business"
    - "For Providers"
    - "Our Plans"
    - "Resources"
    - "About"
    - "Log in"
    - "Help"
    - "Try for free"
  footer-links:
    - "Try 14-days free"
    - "Login"
```

**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:
  logo:
    count: 7
    avg-ratio: 2.93
    common-aspect: "~16:6 banner"
    sample-alts:
      - "Headspace_logo_svg"
      - "Vertex"
  hero:
    count: 2
    avg-ratio: 26.26
    common-aspect: "~16:6 banner"
    sample-alts:
      - "Evergreen yellow banner"
  product:
    count: 3
    avg-ratio: 1.09
    common-aspect: "~1:1 square"
    sample-alts:
      - "desktop hero 2 june5 2x 1 copy"
      - "Jan '25 Campaign Explore Screen Mock"
      - "d-deepdive"
  thumbnail:
    count: 19
    avg-ratio: 0.99
    common-aspect: "~1:1 square"
    sample-alts:
      - "Todo icon"
      - "Todo icon"
      - "Todo icon"
```

**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">
  Stress less
</button>
```
_Source pattern detected: padding `8px 16px 8px 24px` · radius `8px` · weight `400`_

**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:** **nav** 7 · **cta** 5 · **auth** 1 · **blog** 1 · **social** 5 · **footer** 3 · **other** 38

**Primary actions (conversion path):**
- Primary call-to-action — "Sign up for a Headspace account" (the conversion path) → `https://checkout.headspace.com/checkout?voucherCode=B2C14DANNUAL2022&origin=homepage`
- Account access — "Log in" (login/signup) → `https://www.headspace.com/auth/login?returnTo=https%3A%2F%2Fmy.headspace.com%2F&ext-show_enterprise_sso=true`
- Primary call-to-action — "Try for free" (the conversion path) → `https://checkout.headspace.com/checkout?voucherCode=B2C14DANNUAL2022`
- Primary call-to-action — "Try for $0" (the conversion path) → `https://checkout.headspace.com/checkout?voucherCode=B2C14DANNUAL2022&origin=homepage-hero`
- Primary call-to-action — "Get started" (the conversion path) → `https://www.headspace.com/online-therapy`
- Primary call-to-action — "Try 14-days free" (the conversion path) → `https://checkout.headspace.com/checkout?voucherCode=B2C14DANNUAL2022&origin=footer`

**Signals:** 31/60 links carry a featured image · device mockups detected: tablet ×7 · dominant link roles: content-card (24), inline-link (18), footer-link (9).


---
## Coverage: 74% of dimensions extracted

> Coverage measures how much of the design we could read, **not** how pixel-faithful a clone is. For fidelity, see the SSIM/structure score.

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 25 | 25 | 18 named colors |
| Typography | 20 | 20 | 9 roles defined |
| Components | 12 | 20 | 3 specs extracted |
| Motion & Interaction | 12 | 15 | Keyframes |
| CSS Custom Properties | 0 | 10 | 0 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.

*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.

| 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 |
| **Design tokens** | Only 0 CSS custom properties (low signal for semantic naming) | Color names are nearest-neighbor approximations; verify against brand guidelines if available |

### Per-section confidence

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

## 11.1 CSS Implementation Guide (CSS Interception Engine v2.15+)

*Ready-to-use CSS from Prism's CSS Interception Engine — intercepted directly from the site's CSS files (bypasses CORS). Copy-paste into your `<style>` block.*

### Keyframe Animations (Intercepted from CSS)

**1 @keyframes found** — these are the real animation definitions:

```
@keyframes onetrust-fade-in { ... }
```

<details><summary>Full keyframes CSS (1 animations)</summary>

```css
@keyframes onetrust-fade-in{0%{opacity:0}100%{opacity:1}}
```
</details>

### Hover State CSS (Intercepted)

**1 hover rule lines** captured from CSS files. Key interactive transitions from real CSS (not inferred):

```css
#onetrust-banner-sdk .onetrust-vendors-list-handler:hover{color:#1f96db}

#onetrust-banner-sdk .powered-by-logo:hover,#onetrust-banner-sdk .ot-pc-footer-logo a:hover,#onetrust-pc-sdk .powered-by-logo:hover,#onetrust-pc-sdk .ot-pc-footer-logo a:hover,#ot-sync-ntfy .powered-by-logo:hover,#ot-sync-ntfy .ot-pc-footer-logo a:hover{color:#565656}

#onetrust-banner-sdk button.ot-link-btn:hover,#onetrust-pc-sdk button.ot-link-btn:hover,#ot-sync-ntfy button.ot-link-btn:hover{text-decoration:underline;opacity:1}

#ot-sdk-btn.ot-sdk-show-settings:hover,#ot-sdk-btn.optanon-show-settings:hover{color:#fff;background-color:#68b631}

#onetrust-banner-sdk a:hover,#onetrust-pc-sdk a:hover,#ot-sdk-cookie-policy a:hover{color:#565656;text-decoration:none}

#onetrust-banner-sdk .ot-sdk-button:hover,#onetrust-banner-sdk :not(.ot-leg-btn-container)>button:not(.ot-link-btn):hover,#onetrust-banner-sdk :not(.ot-leg-btn-container)>button:not(.ot-link-btn):focus,#onetrust-pc-sdk .ot-sdk-button:hover,#onetrust-pc-sdk :not(.ot-leg-btn-container)>button:not(.ot-link-btn):hover,#onetrust-pc-sdk :not(.ot-leg-btn-container)>button:not(.ot-link-btn):focus,#ot-sdk-cookie-policy .ot-sdk-button:hover,#ot-sdk-cookie-policy :not(.ot-leg-btn-container)>button:not(.ot-link-btn):hover,#ot-sdk-cookie-policy :not(.ot-leg-btn-container)>button:not(.ot-link-btn):focus{color:#333;border-color:#888;opacity:.7}

#onetrust-banner-sdk .ot-sdk-button.ot-sdk-button-primary:hover,#onetrust-banner-sdk button.ot-sdk-button-primary:hover,#onetrust-banner-sdk input[type=submit].ot-sdk-button-primary:hover,#onetrust-banner-sdk input[type=reset].ot-sdk-button-primary:hover,#onetrust-banner-sdk input[type=button].ot-sdk-button-primary:hover,#onetrust-banner-sdk .ot-sdk-button.ot-sdk-button-primary:focus,#onetrust-banner-sdk button.ot-sdk-button-primary:focus,#onetrust-banner-sdk input[type=submit].ot-sdk-button-primary:focus,#onetrust-banner-sdk input[type=reset].ot-sdk-button-primary:focus,#onetrust-banner-sdk input[type=button].ot-sdk-button-primary:focus,#onetrust-pc-sdk .ot-sdk-button.ot-sdk-button-primary:hover,#onetrust-pc-sdk button.ot-sdk-button-primary:hover,#onetrust-pc-sdk input[type=submit].ot-sdk-button-primary:hover,#onetrust-pc-sdk input[type=reset].ot-sdk-button-primary:hover,#onetrust-pc-sdk input[type=button].ot-sdk-button-primary:hover,#onetrust-pc-sdk .ot-sdk-button.ot-sdk-button-primary:focus,#onetrust-pc-sdk button.ot-sdk-button-primary:focus,#onetrust-pc-sdk input[type=submit].ot-sdk-button-primary:focus,#onetrust-pc-sdk input[type=reset].ot-sdk-button-primary:focus,#onetrust-pc-sdk input[type=button].ot-sdk-button-primary:focus,#ot-sdk-cookie-policy .ot-sdk-button.ot-sdk-button-primary:hover,#ot-sdk-cookie-policy button.ot-sdk-button-primary:hover,#ot-sdk-cookie-policy input[type=submit].ot-sdk-button-primary:hover,#ot-sdk-cookie-policy input[type=reset].ot-sdk-button-primary:hover,#ot-sdk-cookie-policy input[type=button].ot-sdk-button-primary:hover,#ot-sdk-cookie-policy .ot-sdk-button.ot-sdk-button-primary:focus,#ot-sdk-cookie-policy button.ot-sdk-button-primary:focus,#ot-sdk-cookie-policy input[type=submit].ot-sdk-button-primary:focus,#ot-sdk-cookie-policy input[type=reset].ot-sdk-button-primary:focus,#ot-sdk-cookie-policy input[type=button].ot-sdk-button-primary:focus{color:#fff;background-color:#1eaedb;border-color:#1eaedb}
```

> **Note**: All values above are extracted from the live site's CSS files. The font files are saved locally by Prism and embedded in the output HTML. Use them as-is for maximum fidelity.

## 11.2 Measured Reality (CDP Engine)

Captured directly from Chrome's engine across **all 3456 rendered nodes** — not a sample. These are the values the page *actually paints*, weighted by how often they appear.

### Real Responsive Breakpoints
**16 breakpoints** read from the live `@media` rules (not guessed) — 14 most relevant:
`400px` · `425px` · `426px` · `428px` · `476px` · `530px` · `550px` · `600px` · `768px` · `769px` · `890px` · `896px` · `897px` · `1023px` … (+2 more)

### Measured Design Scale
**Type scale by usage** (× = paint count): `16px`×2804 · `12px`×135 · `20px`×116 · `24px`×106 · `18px`×96 · `32px`×52 · `16.5186px`×32 · `14px`×17

**Radius scale** (× = paint count): `24px`×27 · `50%`×25 · `16px`×24 · `32px`×18 · `8px`×10 · `800px`×8 · `12px`×3 · `30px`×1

**Weights** (× = paint count): `400`×2926 · `700`×312 · `500`×215

**Layout gaps** (× = paint count): `16px`×21 · `16px 0px`×19 · `8px`×13 · `4px`×10 · `48px`×5 · `40px 16px`×5 · `20px`×3 · `4.8px`×3

**Elevation (real shadows)**:
```css
rgba(20, 19, 19, 0.2) 0px 1px 8px 0px
rgba(65, 61, 69, 0.2) 0px 2px 0px 0px
rgba(20, 19, 19, 0.2) 0px 3.23px 6.45px 0px
```

### Provenance — measured styles on key elements
Read from the live CSSOM (includes runtime-injected CSS). This is *what actually styles the page*, by element:

```css
body { font-family:'Headspace Apercu',sans-serif }
body { color:#2D2C2B }
body { color:#4B4C4D; font-size:16px }
header { background:#FFFFFF; background-color:rgb(255, 255, 255) }
h2 { font-family:Headspace Apercu,sans-serif; font-size:2.25rem; font-weight:bold; color:#2D2C2B }
@media (min-width: 48rem) h2 { font-size:3.25rem }
@media (min-width: 90rem) h2 { font-size:4rem }
@media (min-width: 48rem) h2 { font-size:2.5rem }
button { font-family:inherit; font-size:100% }
button { background:#FFFFFF; font-size:1rem; font-weight:bold; transition:color 150ms cubic-bezier(0.32, 0.94, 0.6, 1),background-color 150ms cubic-bezier(0.32, 0.94, 0.6, 1),border-color 150ms cubic-bezier(0.32, 0.94, 0.6, 1),box-shadow 150ms cubic-bezier(0.32, 0.94, 0.6, 1),transform 150ms cubic-bezier(0.32, 0.94, 0.6, 1); border-radius:0; color:#44423F; background-color:transparent }
a { font-family:Headspace Apercu,sans-serif; font-size:1rem; font-weight:500; color:#2D2C2B }
input { font-family:inherit; font-size:100% }
```

> Selectors normalised to their semantic element — source class names are often build-hashed (`.bgDIHX`) and not reusable. The declarations + CSS vars are the transferable part.

---
*Generated by Prism — automated Playwright extraction + design analysis.*
*Source: https://www.headspace.com | 2026-06-14T15:13:33.826Z*
*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.*