spotify.com

DESIGN.md

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

---
version: alpha
name: spotify.com
description: "Light product system built on #ffffff with #1ed760 as the primary CTA accent. Type anchored in SpotifyMixUI at 16px / weight 700. Extracted automatically from https://spotify.com/ — every value from getComputedStyle(), no approximation."
narrative: |
  spotify.com is built on a pure-white canvas (rgb(255,255,255)).
  The system uses #1ed760 as the high-saturation accent for primary actions.
  Generously rounded CTAs (50%) suggest approachable, content-first design alongside SpotifyMixUI as the primary typeface.

colors:
  background: "#ffffff"
  surface-1: "rgba(255, 255, 255, 0.3)"
  surface-2: "rgba(255, 255, 255, 0.7)"
  ink: "#b3b3b3"
  ink-muted: "#121212"
  ink-subtle: "#292929"
  primary: "#1ed760"
  on-primary: "#ffffff"
  primary-hover: "#1ed760"
  hairline: "#b3b3b3"
  primary-focus: "#b6b6b6"
  semantic-success: "#1ed760"
  semantic-warning: "#ffa42b"

typography:
  display-xl:
    fontFamily: "SpotifyMixUITitle"
    fontSize: 24px
    fontWeight: 700
    lineHeight: normal
    letterSpacing: 0
  body:
    fontFamily: "SpotifyMixUI"
    fontSize: 16px
    fontWeight: 400
    lineHeight: normal
    letterSpacing: 0
  button:
    fontFamily: "SpotifyMixUI"
    fontSize: 16px
    fontWeight: 700
    lineHeight: normal
    letterSpacing: 0
  mono:
    fontFamily: "SpotifyMixUI"
    fontSize: 13.3333px
    fontWeight: 400
    lineHeight: normal
    letterSpacing: 0

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

spacing:
  xxs: 2px
  xs: 4px
  sm: 8px
  md: 12px
  lg: 25px
  xl: 32px
  xxl: 64px
  section: 80px

components:
  button-secondary:
    backgroundColor: "#1f1f1f"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 12px
  button-pill:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.pill}"
    padding: 12px
  button-icon-button:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.pill}"
  card-standard-card:
    backgroundColor: "transparent"
    typography: "{typography.body}"
    rounded: "{rounded.xs}"
    padding: 12px
  input-text-input:
    backgroundColor: "{colors.on-primary}"
    textColor: "#000000"
    typography: "{typography.mono}"
    rounded: "{rounded.none}"
  navigation-main-nav:
    backgroundColor: "transparent"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 16px 16px 8px
  search-bar-search-bar:
    backgroundColor: "transparent"
    textColor: "{colors.hairline}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"

extracted_at: "2026-05-30T20:39:55.785Z"
completeness: 77
scoreVersion: "v2"

---

# Design System — spotify.com
> Extracted automatically by Clone Architect from https://spotify.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(255,255,255)` is the page background. Every component composits against this.
> - **Accent**: `#1ed760` 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: 25px.
> - **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

spotify.com adopts the classic pure-white canvas (`#ffffff`) — a deliberate choice that recedes into transparency, letting typography, color and product imagery carry the entire visual weight. 

Typography is anchored in **SpotifyMixUI**. Headlines use weight 700 for confident, assertive presence — the brand wants to be heard. 

Body text reads in Silver (`#b3b3b3`). **#1ed760** (`#1ed760`) 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. 
Border radius varies from pill-shaped (fully rounded) to moderately rounded elements, creating visual rhythm. Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: Pure White (`#ffffff`)
- Primary typeface: CircularSp-Deva
- Primary text: Silver (`#b3b3b3`)
- Accent: #1ed760 (`#1ed760`)
- Shadow system: 6 distinct elevation levels
- Custom fonts loaded: CircularSp-Deva, CircularSp-Grek, CircularSp-Arab, CircularSp-Cyrl, CircularSp-Hebr, SpotifyMixUI, SpotifyMixUITitle, SpotifyMixUITitleVariable

## 2. Color Palette & Roles

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

### Text & Content
- **Silver** (`#b3b3b3`): Primary body text
- **Text Negative** (`#f3727f`): Text (CSS var)
- **Text Positive** (`#1ed760`): Text (CSS var)
- **Text Announcement** (`#539df5`): Text (CSS var)
- **Jet Black** (`#121212`): Secondary text

### Accent & Interactive
- **#c03038** (`#c03038`): Interactive / accent
- **#183070** (`#183070`): Interactive / accent
- **#d14807** (`#d14807`): Interactive / accent
- **Slate Gray** (`#4868a0`): Interactive / accent
- **Vermillion** (`#cf4740`): Interactive / accent
- **#b03830** (`#b03830`): Interactive / accent
- **#a84858** (`#a84858`): Interactive / accent

### Border & Divider
- **Silver** (`#c5c5c5`): Borders / dividers
- **Silver** (`#c1c1c1`): Borders / dividers

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

- `#000000` — Pure Black
- `#0000ee` — #0000ee
- `#1f1f1f` — Near Black
- `#7c7c7c` — Medium Gray
- `#9d968e` — Cool Gray
- `rgba(118, 118, 118, 0.3)` — Translucent Stone (30%)
- `#535353` — Slate
- `#333333` — Charcoal
- `#102038` — Navy Blue
- `#e00808` — Red
- `#3c8366` — Teal
- `#ae5a8c` — #ae5a8c
- `#6c7982` — Slate Gray
- `#84772f` — #84772f
- `#cc4d46` — Terracotta
- `#183848` — Charcoal
- `#b02818` — #b02818
- `#6e7882` — Slate Gray
- `#0068b8` — #0068b8
- `#402828` — Charcoal
- `#407088` — Slate Gray
- `#e02818` — M Tricolor Red
- `#303838` — Charcoal
- `#405820` — #405820
- `#1f80a5` — #1f80a5
- `#956d6d` — Stone
- `#6e7881` — Slate Gray
- `#607880` — Slate Gray
- `#7c766a` — Stone
- `#d02820` — M Tricolor Red
- `#8e69a3` — #8e69a3
- `#5060a8` — #5060a8
- *…+18 more in `raw-css.json` (`desktop.allColors`).*

### CSS Custom Properties (Design Tokens)

**Shadow Token**
- `--encore-overlay-drop-shadow`: `0 4px 6px #0000004d`
- `--encore-overlay-box-shadow`: `0 4px 12px 0 #0000004d`
- `--encore-focus-box-shadow`: `0 3px 0 0`

**Motion Token**
- `--scrollAnimationRangeStart`: `0px`
- `--encore-productive-exit-duration`: `.2s`
- `--scrollAnimationRangeEnd`: `0px`

**Spacing Token**
- `--content-spacing`: `16px`
- `--encore-spacing-looser-4`: `64px`
- `--encore-spacing-looser-6`: `128px`
- `--encore-spacing-tighter-5`: `2px`

**Border Radius Token**
- `--encore-corner-radius-larger-2`: `8px`
- `--encore-border-radius-rounded`: `9999px`
- `--encore-corner-radius-larger`: `6px`
- `--encore-corner-radius-base`: `4px`

**Z-Index Token**
- `--encore-z-index-popover`: `1060`
- `--encore-z-index-dialog`: `1050`
- `--encore-z-index-skiplink`: `9999`
- `--top-bar-z-index`: `1`

**Other tokens**
- `--text-negative`: `#f3727f`
- `--encore-text-size-smaller-2`: `.75rem`
- `--encore-text-size-larger-3`: `3rem`
- `--encore-text-size-larger-5`: `6rem`
- `--start-gradient-color`: `rgb(0, 0, 0)`
- `--encore-text-size-base`: `1rem`
- `--text-subdued`: `#b3b3b3`
- `--text-warning`: `#ffa42b`

## 3. Typography Rules

### Font Families
- **Primary**: `SpotifyMixUI`
- **Secondary**: `CircularSp-Deva`
- **Font 3**: `CircularSp-Grek`
- **Font 4**: `CircularSp-Arab`
- **Font 5**: `CircularSp-Cyrl`

### Custom Fonts Loaded
- **CircularSp-Deva** weight 800 (normal)
- **CircularSp-Deva** weight 700 (normal)
- **CircularSp-Deva** weight 400 (normal)
- **CircularSp-Grek** weight 800 (normal)
- **CircularSp-Grek** weight 700 (normal)
- **CircularSp-Grek** weight 400 (normal)
- **CircularSp-Arab** weight 800 (normal)
- **CircularSp-Arab** weight 700 (normal)
- **CircularSp-Arab** weight 400 (normal)
- **CircularSp-Cyrl** weight 800 (normal)
- **CircularSp-Cyrl** weight 700 (normal)
- **CircularSp-Cyrl** weight 400 (normal)
- **CircularSp-Hebr** weight 800 (normal)
- **CircularSp-Hebr** weight 700 (normal)
- **CircularSp-Hebr** weight 400 (normal)
- **SpotifyMixUI** weight 700 (normal)
- **SpotifyMixUI** weight 400 (normal)
- **SpotifyMixUITitle** weight 800 (normal)
- **SpotifyMixUITitle** weight 700 (normal)
- **SpotifyMixUITitleVariable** weight 100 1000 (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | SpotifyMixUITitle | 24px | 700 | normal | normal | Main headline (h2) |
| Card Title | SpotifyMixUI | 16px | 400 | normal | normal | Card headings |
| Button Large | SpotifyMixUI | 16px | 700 | normal | normal | Button label (16px) |
| Button | SpotifyMixUI | 14px | 700 | normal | normal | Button label (14px) |
| Input | SpotifyMixUI | 13.3333px | 400 | normal | normal | Form input (13.3333px) |

### Full Font Size Scale

Sizes detected in the design (descending): `24px`, `16px`, `14px`, `13.33px`, `12px`, `11px`, `10.50px`

> 3 size(s) detected outside the sampled hierarchy (12px, 11px, 10.5px). 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

**Secondary**
- Background: `#1f1f1f`
- Text: `#b3b3b3` `{colors.hairline}`
- Padding: 12px
- Radius: 50%
- Font: 16px weight 400
- Use: Secondary action
- Hover: transform: `matrix(1.04, 0, 0, 1.04, 0, 0)`
- Focus: color: `rgb(182, 182, 182)`, border: `0px none rgb(182, 182, 182)`, borderColor: `rgb(182, 182, 182)`

**Pill**
- Background: `transparent`
- Text: `#b3b3b3` `{colors.hairline}`
- Padding: 12px
- Radius: 9999px
- Font: 16px weight 400
- Use: Status pills, tags, chips
- Hover: transform: `matrix(1.04, 0, 0, 1.04, 0, 0)`
- Focus: color: `rgb(182, 182, 182)`, border: `0px none rgb(182, 182, 182)`, borderColor: `rgb(182, 182, 182)`

**Icon Button**
- Background: `transparent`
- Text: `#b3b3b3` `{colors.hairline}`
- Padding: 0px
- Radius: 9999px
- Font: 16px weight 400
- Use: Toolbar/UI icons
- Hover: transform: `matrix(1.04, 0, 0, 1.04, 0, 0)`
- Focus: color: `rgb(182, 182, 182)`, border: `0px none rgb(182, 182, 182)`, borderColor: `rgb(182, 182, 182)`

**Pill**
- Background: `transparent`
- Text: `#b3b3b3` `{colors.hairline}`
- Padding: 8px 0px
- Radius: 9999px
- Font: 16px weight 700
- Use: Status pills, tags, chips
- Hover: transform: `matrix(1.04, 0, 0, 1.04, 0, 0)`
- Focus: color: `rgb(182, 182, 182)`, border: `0px none rgb(182, 182, 182)`, borderColor: `rgb(182, 182, 182)`

**Icon Button**
- Background: `#1f1f1f`
- Text: `#b3b3b3` `{colors.hairline}`
- Padding: 8px
- Radius: 9999px
- Font: 13.3333px weight 400
- Use: Toolbar/UI icons
- Hover: transform: `matrix(1.04, 0, 0, 1.04, 0, 0)`
- Focus: color: `rgb(182, 182, 182)`, border: `0px none rgb(182, 182, 182)`, borderColor: `rgb(182, 182, 182)`

### Cards & Containers

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

### Inputs & Forms

**Text Input**
- Background: `#ffffff` `{colors.on-primary}`
- Text: `#000000`
- Padding: 0px
- Radius: 0px
- Border: 1px solid rgb(193, 193, 193)
- Font: 13.3333px weight 400
- Use: Text fields, search inputs
- Focus: boxShadow: `rgba(0, 0, 0, 0) 0px 0px 0px 0px inset`, cursor: `auto`

### Navigation

**Main Nav**
- Background: `transparent`
- Padding: 16px 16px 8px
- Radius: none
- Font: 16px weight 400
- Use: Fixed/sticky flex nav — N/A items
- Hover: transform: `matrix(1, 0, 0, 1, 0, 0)`

### Search Bar

**Search Bar**
- Background: `transparent`
- Text: `#b3b3b3` `{colors.hairline}`
- Padding: 0px
- Radius: 0px
- Font: 16px weight 400
- Use: Inline search form
- Focus: boxShadow: `rgba(0, 0, 0, 0) 0px 0px 0px 0px inset`, cursor: `auto`


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative

- **Button**:
  - **hover:** transform applied
  - **focus:** text #b3b3b3 → #b6b6b6, border changes
- **Input**:
  - **focus:** shadow added
- **NavLink**:
  - **hover:** transform applied

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

```yaml
component-behaviors:
  button:
    default:
      bg: "rgb(31, 31, 31)"
      fg: "rgb(179, 179, 179)"
    hover:
      bg: "rgb(31, 31, 31)"
      fg: "rgb(179, 179, 179)"
    focus:
      bg: "rgb(31, 31, 31)"
      fg: "rgb(182, 182, 182)"
  input:
    default:
      bg: "rgb(31, 31, 31)"
      fg: "rgb(255, 255, 255)"
    focus:
      bg: "rgb(31, 31, 31)"
      fg: "rgb(255, 255, 255)"
      shadow: "rgba(0, 0, 0, 0) 0px 0px 0px 0px inset"
  link:
    default:
      bg: "rgb(255, 255, 255)"
      fg: "rgb(0, 0, 238)"
  card:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(255, 255, 255)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 238)"
    hover:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(0, 0, 238)"
  badge:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(179, 179, 179)"
      shadow: "rgb(128, 128, 128) 0px 0px 5px 0px"
```

**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
- **5 shape(s)** in this system: `Secondary`, `Pill`, `Icon Button`, `Pill`, `Icon Button`
- **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

### Search Bar
- **1 shape(s)** in this system: `Search Bar`
- **DO NOT introduce new search bar variants** without justification

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
1955px

### Spacing System
Compact spacing — information density prioritized

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 4px |
| sm | 8px |
| md | 12px |
| base | 16px |
| lg | 25px |
| xl | 32px |
| 2xl | 48px |
| 3xl | 64px |

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

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `50%` |
| Cards & Containers | `6px` |
| Inputs & Forms | `0px` |
| Navigation | `none` |
| Search Bar | `0px` |
| Page Body | `0px` |
| Primary Input | `0px` |

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

**Full Radius Spectrum**: 0px, 2px, 4px, 6px, 8px, 32px, 500px, full/pill (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** | `64px` | Top/bottom of full-bleed hero sections |
| **section** | `32px` | Between major bands (color change, content shift) |
| **subsection** | `25px` | Within a section, between content groups |
| **card** | `12px` | 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.**

### Hero Pattern

- **Composition:** centered — Centered composition — heading + subheading + CTAs stacked vertically, content centered horizontally. Common for SaaS marketing pages.
- **Viewport coverage:** 59px tall (not full-viewport)
- **Heading:** "Bibliothèque" — 16px left-aligned
- **CTAs:** none detected in hero (unusual — agent should verify)
- **Clone instruction:** Reproduce the **centered** layout. Use the heading font-size token at the documented size. No imagery needed for hero — text-driven.

### Navigation Pattern

- **Position:** static (scrolls with page)
- **Layout:** unknown — Layout not classified
- **Height:** 754px
- **Logo:** ✗ absent
- **Nav links:** 7 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:** 1005×314px (aspect 3.2:1)
- **Gap:** 24px between cards
- **Content:** ✓ image
- **Image position:** left
- **Clone instruction:** Build a 1-column grid (desktop) with cards at ~3.2:1 aspect ratio. Each card has an image at the left.

### Footer Pattern

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

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |
| Layered (Level 1) | <br>`rgb(128, 128, 128) 0px 0px 5px 0px` | Cards, elevated surfaces |
| Inset (Level 2) | <br>`rgb(18, 18, 18) 0px 1px 0px 0px`,<br>`rgb(124, 124, 124) 0px 0px 0px 1px inset` | Buttons, pressed-state elements |
| Layered (Level 3) | <br>`rgba(0, 0, 0, 0.5) 0px 2px 4px 0px` | Cards, elevated surfaces |
| Layered (Level 4) | <br>`rgba(0, 0, 0, 0.5) 0px 8px 24px 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 |
|-------|---------------|
| `ease` | CSS ease — Default |
| `ease-in` | Ease In — Accelerating |
| `cubic-bezier(0.3,0,0,1)` | Ease Out — Decelerating |

### Duration Scale

| CSS Variable | Value | Tier |
|--------------|-------|------|
| `--encore-productive-exit-duration` | `.2s` | Normal |

### Copy-Paste Transition Snippets

**Background**
```css
transition: background 0.5s cubic-bezier(0.3, 0, 0.4, 1);
```

**Opacity**
```css
transition: opacity 0.3s ease-in;
```

**Background**
```css
transition: background-color 0.2s ease-in-out, color 0.2s ease-in-out;
```

**All Props**
```css
transition: width 0.22s ease-in;
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `onetrust-fade-in` | Fade | opacity | Element entrance |

### Motion Fingerprint

- **Speed Character**: Balanced Pacing (median duration: `220ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 1 unique animation (1 total including variants)

> This design moves with balanced pacing timing using custom cubic-bezier curves, creating a UI that feels natural and fluid.

## 8. Do's and Don'ts

### Do
- Use SpotifyMixUI 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 full-pill radius (9999px) only for specific elements (avatars, pills, toggles)
- Use #1ed760 (`#1ed760`) as the primary accent — it's the brand's signature interactive color
- Use pill-shaped radius (9999px) for primary CTA buttons — the brand uses fully-rounded, pill CTAs
- Apply 12px padding inside cards — matches the design system's content breathing room
- Use 6px border-radius on cards — consistent with the grid card corners
- Style form inputs with a `1px solid rgb(193, 193, 193)` border — use border-based inputs, not floating labels or underline-only
- Respect the 4px–32px spacing range — the design uses a wide scale for visual breathing room
- Keep the hero centered and text-driven — no decorative media, typography carries the message
- Each card includes a left image — imagery is part of the card identity, not optional

### Don't
- 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 apply pill radius on rectangular buttons or cards — it's reserved for specific interactive elements
- Don't introduce additional saturated accent colors — the palette is intentionally controlled
- Don't use rectangular buttons for primary actions — the rounded pill shape is the brand standard
- Don't remove the input border — the border is the primary affordance indicator for form fields
- Don't add hero illustrations or photos — they'll break the typographic restraint
- 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
- Don't over-build the footer — this design keeps it minimal (1 cols, 0 links)


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

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 400px | Single column, compact spacing |
| Mobile Large | 500px | Expanded mobile layout |
| Mobile Large | 550px | 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 |
|---------|----------|---------|--------|
| nav | display | `flex` | `block` |
| nav | flex-direction | `column` | `row` |
| nav | height | `754px` | `1091px` |
| button | padding | `12px` | `0px` |
| button | font-size | `16px` | `13px` |
| button | width | `48px` | `145px` |
| card | padding | `12px` | `8px` |
| card | width | `195.5px` | `168px` |
| sidebar | width | `1424px` | `390px` |
| sidebar | display | `flex` | `block` |

### Collapsing Strategy
- Navigation: flex → block on mobile
- Cards: multi-column → stacked vertical on mobile
- Footer: multi-column → stacked single column on mobile

### Touch Targets
- Buttons: 12px 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):

*No major structural differences detected between desktop and mobile widgets. The same blueprints scale rather than collapse — verify by inspecting actual mobile render.*

## 9b. Visual Tone & Photography

**Tone:** Mixed photography + illustration

A balanced mix of photographic content and vector graphics. Photos likely carry product/lifestyle context while SVG handles icons, logos, and decorative accents.

**Hero Image (above-fold dominant visual):**
- Aspect: 1:1 (square / portrait)
- Rendered size: 172×172px
- *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): 0 (0%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 54 (100%)

**Media Format Mix:**
- JPG: 4 (typically photographic content)

**Average rendered image size:** 172×172px
**Above-fold image count:** 40 / 54

**Decorative Patterns Detected:**
- 3 multi-stop linear gradients (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth
- 1 background pattern (non-photo url() backgrounds) — textures/illustrations as backdrops

**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:**
- Mix photography and illustration intentionally: photos for product/context, vectors for icons + decorative accents.
- Respect the format split — replacing JPGs with illustrations (or vice versa) will shift the brand tone.

## 10. Agent Prompt Guide

### Quick Reference
- Background: Pure White (`#ffffff`)
- Primary text: Silver (`#b3b3b3`)
- Accent: #1ed760 (`#1ed760`)
- Border: Silver (`#b3b3b3`)
- Font: SpotifyMixUI
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Pure White background (#ffffff). Headline at 16px SpotifyMixUI weight 700, line-height normal, color #b3b3b3."
- "Create the primary CTA button: `#1ed760` background, `#b3b3b3` text, 50% border-radius, 12px padding, 700 weight, SpotifyMixUI font."
- "Design a card on `transparent` background. Border: none. Radius: 6px. Shadow: none. Padding: 12px."
- "Build navigation: static on `#ffffff`. SpotifyMixUI 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 SpotifyMixUI, weight range 400–700. Never exceed 700 — heavier weights break the brand's tonal restraint.
3. **Accent**: #1ed760 (`#1ed760`) is the sole interactive color. On hover → #1ed760 (`#1ed760`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.3,0,0.4,1)`. Timing: 200ms for micro-interactions, 200ms for layout changes. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `50%`, cards at `6px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (4px–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-hairline: #b3b3b3;
  --ca-ink-muted: #121212;
  --ca-ink-subtle: #292929;
  --ca-semantic-success: #1ed760;
  --ca-primary-focus: #b6b6b6;
  --ca-semantic-warning: #ffa42b;
}

/* Typography */
:root {
  --ca-font-primary: "SpotifyMixUITitle", system-ui, sans-serif;
  --ca-text-display: 24px;
  --ca-text-body: 16px;
  --ca-text-button: 16px;
  --ca-text-mono: 13.3333px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 4px;
  --ca-space-sm: 8px;
  --ca-space-md: 12px;
  --ca-space-base: 16px;
  --ca-space-lg: 25px;
  --ca-space-xl: 32px;
  --ca-space-2xl: 48px;
  --ca-space-3xl: 64px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 4px;
  --ca-radius-sm: 8px;
  --ca-radius-md: 8px;
  --ca-radius-lg: 8px;
  --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: unknown
    tag: div
    height: 900px
    width: full-bleed
    layout: block
    children: 1
  - section: navigation
    tag: nav
    classes: ["zOQ0BU6AULAqd7Qd"]
    height: 754px
    width: 331px
    layout: flex-column justify=normal
    children: 1
  - section: main-content
    tag: main
    classes: ["J6wP3V0xzh0Hj_MS"]
    height: 754px
    width: 1085px
    layout: block
    children: 2
  - section: section-7
    tag: section
    classes: ["JlQyoTD6puMgqY_y", "CDyHWsKVsLAC4HFx"]
    height: 1701px
    width: 1085px
    layout: block
    children: 2
    padding: "4px 0px 32px"
  - section: unknown
    tag: div
    classes: ["main-view-container"]
    height: 754px
    width: 1085px
    layout: block
    children: 4
  - section: unknown
    tag: div
    classes: ["main-view-container__scroll-node", "qLlzLghnvcCySJ8T"]
    height: 754px
    width: 1085px
    layout: flex-row justify=normal
    children: 3
  - section: unknown
    tag: div
    classes: ["main-view-container__scroll-node-child"]
    height: 754px
    width: 1085px
    layout: block
    children: 1
  - section: section-8
    tag: section
    classes: ["l3tPikCftuELMOzz", "e4IK04uNVRsB6jbO", "yTHNsGSMiG01kxo3"]
    height: 329px
    width: 1005px
    layout: flex-column justify=normal
    children: 2
  - section: section-5
    tag: section
    classes: ["q8mQFn7r8UYsKdHE", "tMFkXbMSXNUegQIu", "aIU4qABgiIgjAEyD", "LUVEWqx9qW4kwbPr"]
    height: 134px
    width: 315px
    layout: flex-column justify=center
    children: 2
    bg: "rgb(31, 31, 31)"
    padding: "16px 20px"
  - section: section-6
    tag: section
    classes: ["q8mQFn7r8UYsKdHE", "tMFkXbMSXNUegQIu", "aIU4qABgiIgjAEyD", "LUVEWqx9qW4kwbPr"]
    height: 176px
    width: 315px
    layout: flex-column justify=center
    children: 2
    bg: "rgb(31, 31, 31)"
    padding: "16px 20px"
  - section: section-9
    tag: section
    classes: ["l3tPikCftuELMOzz", "e4IK04uNVRsB6jbO", "yTHNsGSMiG01kxo3"]
    height: 306px
    width: 1005px
    layout: flex-column justify=normal
    children: 2
  - section: section-10
    tag: section
    classes: ["l3tPikCftuELMOzz", "e4IK04uNVRsB6jbO", "yTHNsGSMiG01kxo3"]
    height: 328px
    width: 1005px
    layout: flex-column justify=normal
    children: 2
  - section: section-11
    tag: section
    classes: ["l3tPikCftuELMOzz", "e4IK04uNVRsB6jbO", "yTHNsGSMiG01kxo3"]
    height: 304px
    width: 1005px
    layout: flex-column justify=normal
    children: 2
  - section: section-12
    tag: section
    classes: ["l3tPikCftuELMOzz", "e4IK04uNVRsB6jbO", "yTHNsGSMiG01kxo3"]
    height: 304px
    width: 1005px
    layout: flex-column justify=normal
    children: 2
  - section: footer
    tag: div
    classes: ["main-view-container__mh-footer-container"]
    height: 466px
    width: 1085px
    layout: block
    children: 2
    bg: "rgb(18, 18, 18)"
    padding: "40px 0px 0px"
  - section: navigation
    tag: nav
    classes: ["esBjsh"]
    height: 377px
    width: 1085px
    layout: block
    children: 3
    bg: "rgb(18, 18, 18)"
    padding: "8px 32px 40px"
```

**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:
    - "Titres tendance"
  ctas:
    - "Premium"
    - "Installer l'appli"
    - "S'inscrire"
    - "Se connecter"
    - "Créer une playlist"
    - "Parcourir les podcasts"
  navigation:
    - "Passer au contenu principal"
    - "Installer l'appli"
    - "Parcourir les podcasts"
    - "Légal"
    - "Protection des données"
    - "À propos des pubs"
    - "Accessibilité"
    - "Cookies"
    - "Titres tendance"
    - "Tout afficher"
```

**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: 50
    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">
  Action
</button>
```
_Source pattern detected: padding `12px` · radius `50%` · weight `400`_

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

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


---
## Extraction Completeness: 77/100 (B)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 21 | 25 | 15 named colors |
| Typography | 13 | 20 | 5 roles defined |
| Components | 20 | 20 | 5 specs extracted |
| Motion & Interaction | 12 | 15 | Keyframes present |
| CSS Custom Properties | 7 | 10 | 139 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 | 139 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 5 typography roles inferred |
| §4 Components | High | 5 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 21 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 6 breakpoints detected |
| §9b Photography | High | 54 images, hero present |

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