Spotify — decoded design system

spotify.com · dark · modern · custom · deep decode — measured live

Spotify's design system, decoded live by Mozaika: measured color roles, type scale, buttons with real hover/focus states, motion and the brand's own tokens.

Open in Mozaika →

This is a static, crawlable rendering for search & AI engines. The interactive version — filters, live decode console, copy & export — is at https://mozaika.design/decode/spotify.com.

Decoded design system

Spotify's decoded design system: background #121212, text #B3B3B3, accent #1ED760, link #FFFFFF, primary #1ED760; type scale h1 24px / h2 18px / body 14px; 4px spacing base; 0px base radius. The single interactive/action color is #EEEEEE — used only on interactive or must-notice elements (buttons, links, key highlights), never on large fills.

Color roles

Using these colors

• Action color #EEEEEE — the single interactive color; only on things you click or must notice, never large fills.
• primary, accent are all #1ED760 — one role, not several (the action color).
• accent #1ED760 — accent for emphasis — keep it rare on the page.
• link #FFFFFF — reads as a neutral UI color, not a link accent — verify against the reference (action = #EEEEEE).
• secondary #9D968E — optional secondary accent — LOW decode confidence; use rarely (a status color or a single decorative moment) or omit it entirely. Prefer one accent unless the reference clearly shows two.

Typography

• Heading: Spotify Mix
• Body: Spotify Mix
• h1: 24px
• h2: 18px
• body: 14px

Spacing

• base unit: 4px
• scale: 2px, 4px, 5px, 6px, 8px, 12px, 16px, 20px, 24px, 28px

Radii

• base: 0px
• button: 500px

Shadows (elevation)

• card: rgba(0, 0, 0, 0.3) 0px 8px 8px 0px
• overlay: rgba(0, 0, 0, 0.5) 0px 8px 24px 0px

Motion

Micro-interactions run at 150ms (dominant) with cubic-bezier(0.3, 0, 0, 1).

• durations: 150ms · 200ms · 250ms
• easings: cubic-bezier(0.3, 0, 0, 1) · ease-out
• animated properties: transform, background-color, opacity, color

Native design tokens

…and 99 more measured on the page.

Button states (measured)

• primary focus: outline 1px solid rgb(0, 0, 0)

Layout (measured)

• nav: 754px
• common grid: 2 columns

Motion choreography (measured)

Load order: div.os-scrollbar-handle → h2.e-10451-text → div.r10xDelHVNgJK_xY×8 → p.e-10451-text×8 → span.e-10451-text×6 → div.P0DCrcBH45YVGZwP×30

Scroll reveal: 3 elements rest at opacity 0, animate in over 0.15s ease-out.

Overlay recipe (measured)

dialog panel: rgba(0, 0, 0, 0) · radius 0px

Input (measured)

height 48px · radius 500px · focus ring 1px auto rgb(16, 16, 16)

Responsive (measured)

• breakpoints: 425px · 550px · 600px · 768px · 896px · 1024px
• mobile (390px): hero 16px · nav inline

Install it

Drop this measured system into any shadcn/Tailwind project in one command:

npx shadcn add mozaika.design/r/decode/spotify.com

registry item · or query it over MCP: get_design_system("Spotify")

Export: DESIGN.md

# Spotify — Design System

> dark, modern, high, custom — deep decode (measured live)

## Colors

| Role | Value |
|------|-------|
| bg | `#121212` |
| surface | `#1B1B1B` |
| border | `#2A2A2A` |
| text | `#B3B3B3` |
| text_muted | `#757575` |
| primary | `#1ED760` |
| accent | `#1ED760` |
| link | `#FFFFFF` |
| secondary | `#9D968E` |
| button_bg | `#EEEEEE` |
| button_text | `#181818` |

**Using these colors**

- **Action color** `#EEEEEE` — the single interactive color; it appears only on things you click or must notice (buttons, key highlights), never on large fills or backgrounds.
- `primary`, `accent` are all `#1ED760` — one role, not several.
- **accent** `#1ED760` — accent for emphasis — keep it rare on the page.
- **link** `#FFFFFF` — reads as a neutral UI color, not a link accent — verify against the reference (action = #EEEEEE).
- **secondary** `#9D968E` — optional secondary accent — LOW decode confidence; use rarely (a status color or a single decorative moment) or omit it entirely. Prefer one accent unless the reference clearly shows two.
- **Page coverage** (full-page screenshot pixels): `#121212` 45% · `#EEEEEE` 40.1% · `#A7A6A3` 8% · `#332D2C` 6.8%

## Typography

- Heading: **Spotify Mix** _(free fallback: Newsreader)_
- Body: **Spotify Mix** _(free fallback: Newsreader)_

| Role | Size / weight · line-height · tracking |
|------|------------------------------------------|
| hero | 24px / 700 |
| h2 | 18px / 600 · lh 23px |
| body | 14px / 400 · lh 19px |
| small | 12px / 400 |
| eyebrow | 14px / 600 · tracking 1.4px |

- Weight ladder: 400 · 600 · 700 — use these exact measured weights, not the 400/600 defaults.

> **Fonts —** Spotify Mix may be proprietary — safe free fallback: Newsreader (Google Fonts).

## Spacing
- base unit: 4px (inferred from the measured scale)
- measured scale: 2px, 4px, 5px, 6px, 8px, 12px, 16px, 20px, 24px, 28px — snap all gaps/padding to these
- section rhythm: 40px top/bottom padding per section (measured)

## Radius
- base: 0px
- button: 500px
- card: 6px
- pill: 9999px
- sharp: 2px

## Buttons

| Button | Fill / text | Border | Radius | Padding | Font | Shadow |
|--------|-------------|--------|--------|---------|------|--------|
| primary | `#EEEEEE` / `#181818` | none | 500px | 0px 0px 0px 0px | 600 14px / 1.4px | none |
| secondary | `rgba(0, 0, 0, 0)` / `#B3B3B3` | none | 9999px | 4px 16px 4px 36px | 700 14px | none |

**States (measured, not guessed)**

- primary focus: outline `1px solid rgb(0, 0, 0)`
- secondary hover: color `#FFFFFF` · transform `matrix(1.04, 0, 0, 1.04, 0, 0)`

## Shadows (elevation)
- card: `rgba(0, 0, 0, 0.3) 0px 8px 8px 0px`
- overlay: `rgba(0, 0, 0, 0.5) 0px 8px 24px 0px`

## Motion
- durations: 150ms (dominant) · 200ms · 250ms
- easings: `cubic-bezier(0.3, 0, 0, 1)` (dominant) · `ease-out`
- animated properties: transform, background-color, opacity, color

Micro-interactions use the dominant duration + easing; nothing on the page animates slower than the longest duration above — don't invent springier motion.

## Their own tokens (verbatim from :root)

| Token | Value |
|-------|-------|
| `--essential-announcement` | `#1278f2` |
| `--background-base` | `#121212` |
| `--background-elevated-press` | `#191919` |
| `--background-elevated-highlight` | `#2a2a2a` |
| `--start-gradient-color` | `#000000` |
| `--essential-positive` | `#1ed760` |
| `--text-warning` | `#ffa42b` |
| `--decorative-base` | `#fff` |
| `--text-positive` | `#1ed760` |
| `--background-elevated-base` | `#1f1f1f` |
| `--end-gradient-color` | `#000000` |
| `--background-tinted-highlight` | `#ffffff24` |

_…and 97 more measured on the page._

Prefer these names when extending their system — it's the brand's actual vocabulary.

## Layout (measured)
- common grid: 2-col
- nav: 754px

| Section (y) | Height | Cols | Gap | Pad y | Split |
|---|---|---|---|---|---|
| 64 | 1743 | — | — | 0/0 | — |
| 443 | 306 | — | — | 0/0 | — |
| 772 | 348 | — | — | 0/0 | — |
| 1144 | 304 | — | — | 0/0 | — |
| 1471 | 304 | — | — | 0/0 | — |
| 1807 | 450 | — | — | 40/0 | — |
| 1936 | 212 | 2 | — | 0/0 | 85/15 |

## Motion choreography (measured)
Load order: `div.os-scrollbar-handle` @0ms → `h2.e-10451-text` @0ms → `div.r10xDelHVNgJK_xY`×8 @0ms → `p.e-10451-text`×8 @0ms → `span.e-10451-text`×6 @1ms → `div.P0DCrcBH45YVGZwP`×30 @4ms
- `img.obD7rdENNc2n3fC0` ×24 — opacity 0→1 — 250ms ease
- scroll reveal: 3 elements rest at opacity 0, animate in over 0.15s ease-out (0 revealed during the drive).
- overlay dialog (auto-opened): panel rgba(0, 0, 0, 0) · r 0px

Rebuild the timeline, not just the durations — order, delays and staggers above are the choreography.

## Components (measured)
- input: h 48px · r 500px · bg #1F1F1F · placeholder #B3B3B3
  - focus ring: `1px auto rgb(16, 16, 16)` — this exact construction, don't invent your own
- link: #FFFFFF · no underline
- disabled: bg rgba(0, 0, 0, 0) · text #B3B3B3

## Responsive (measured)
- breakpoints: 425px · 550px · 600px · 768px · 896px · 1024px
- mobile (390px): hero 16px · body 16px · nav: inline

## How to apply
Paste the Tailwind `@theme` (or CSS variables) as your base, then build each
section to its spec — verify every color, radius, and font against these tokens.
Hover/focus states, shadows and motion timings above are measured from the live page — match them exactly, don't re-guess them.

An automated reading of Spotify's publicly-visible CSS (colors, fonts, spacing, motion) — not affiliated with spotify.com. No screenshots stored. Removal requests: hello@mozaika.design.