MozaikaDesign system

Spotify — Design System

dark · modern · high · custom · confidence 92% · deep decode

The Spotify web player is pure app-scale design: Spotify Mix at UI sizes (24px shelf titles, 16px everything else) over near-black, full-pill controls, and a grid of album art doing all the visual heavy lifting. Chrome recedes to charcoal so cover art becomes the palette — the interface as a record-store wall lit at night, with Spotify green saved for play.

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/ds/spotify.

Tokens

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

Color roles

RoleValue
bg#121212
surface#202020
border#353535
text#FFFFFF
text_muted#A4A4A4
primary#1ED760
accent#1ED760
link#0000EE
secondary#9D968E
button_bg#000000
button_text#B3B3B3

Using these colors

Typography

Spacing

Radii

Shadows (elevation)

Motion

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

Native design tokens

TokenValue
--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

…and 99 more measured on the page.

Button states (measured)

Layout (measured)

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)

Per-section tokens (15)

Export: DESIGN.md

# Spotify — Design System

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

The Spotify web player is pure app-scale design: Spotify Mix at UI sizes (24px shelf titles, 16px everything else) over near-black, full-pill controls, and a grid of album art doing all the visual heavy lifting. Chrome recedes to charcoal so cover art becomes the palette — the interface as a record-store wall lit at night, with Spotify green saved for play.

## Colors

| Role | Value |
|------|-------|
| bg | `#121212` |
| surface | `#202020` |
| border | `#353535` |
| text | `#FFFFFF` |
| text_muted | `#A4A4A4` |
| primary | `#1ED760` |
| accent | `#1ED760` |
| link | `#0000EE` |
| secondary | `#9D968E` |
| button_bg | `#000000` |
| button_text | `#B3B3B3` |

**Using these colors**

- **Action color** `#000000` — 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** `#0000EE` — fails contrast on the background (~2.0:1) — this is a dark UI color, NOT a readable link; use the text or action color for links (verify against the reference).
- **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: 9999px
- 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.

---

> **Decoded with Mozaika** — measured live, not guessed. Full decoded design system + one-command install: mozaika.design/ds/spotify

Export: Tailwind v4 (@theme)

@theme {
  /* action color #000000 — the one interactive color; buttons/links/emphasis only, never large fills. */
  --color-bg: #121212;
  --color-surface: #202020;
  --color-border: #353535;
  --color-text: #FFFFFF;
  --color-text-muted: #A4A4A4;
  --color-primary: #1ED760;  /* a brand color — but the call-to-action uses #000000, not this. */
  --color-accent: #1ED760;  /* accent for emphasis — keep it rare on the page. */
  --color-link: #0000EE;  /* fails contrast on the background (~2.0:1) — this is a dark UI color, NOT a readable link; use the text or action color for links (verify against the reference). */
  --color-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. */
  --color-button-bg: #000000;  /* primary-button fill — the main call-to-action color. */
  --color-button-text: #B3B3B3;
  /* fonts: Spotify Mix may be proprietary — safe free fallback: Newsreader (Google Fonts). */
  --font-heading: "Spotify Mix", "Newsreader", system-ui, -apple-system, 'Segoe UI', sans-serif;
  --font-body: "Spotify Mix", "Newsreader", system-ui, -apple-system, 'Segoe UI', sans-serif;
  /* measured weights: 400, 600, 700 — use these, not 400/600 */
  --text-hero: 24px; --font-weight-hero: 700;
  --text-h2: 18px; --font-weight-h2: 600; --leading-h2: 23px;
  --text-body: 14px; --font-weight-body: 400; --leading-body: 19px;
  --text-small: 12px; --font-weight-small: 400;
  --text-eyebrow: 14px; --font-weight-eyebrow: 600; --tracking-eyebrow: 1.4px;
  --radius-base: 0px;
  --radius-button: 9999px;
  --radius-card: 6px;
  --radius-pill: 9999px;
  --radius-sharp: 2px;
  --shadow-card: rgba(0, 0, 0, 0.3) 0px 8px 8px 0px;
  --shadow-overlay: rgba(0, 0, 0, 0.5) 0px 8px 24px 0px;
  --outline-focus: 1px solid rgb(0, 0, 0);  /* measured focus ring */
  --ease-brand: cubic-bezier(0.3, 0, 0, 1);
  --duration-fast: 150ms;  /* use: duration-[var(--duration-fast)] */
  --duration-base: 200ms;
  --duration-slow: 250ms;
  --section-y: 40px;  /* per-section vertical padding (measured) */
  --spacing: 4px;  /* measured base — drives the p-*/gap-* scale. steps seen on the page: 2, 4, 5, 6, 8, 12, 16, 20, 24, 28px */
}

Export: CSS variables

:root {
  /* action color #000000 — the one interactive color; buttons/links/emphasis only, never large fills. */
  --bg: #121212;
  --surface: #202020;
  --border: #353535;
  --text: #FFFFFF;
  --text-muted: #A4A4A4;
  --primary: #1ED760;  /* a brand color — but the call-to-action uses #000000, not this. */
  --accent: #1ED760;  /* accent for emphasis — keep it rare on the page. */
  --link: #0000EE;  /* fails contrast on the background (~2.0:1) — this is a dark UI color, NOT a readable link; use the text or action color for links (verify against the reference). */
  --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. */
  --button-bg: #000000;  /* primary-button fill — the main call-to-action color. */
  --button-text: #B3B3B3;
  --font-heading: "Spotify Mix", "Newsreader", system-ui, -apple-system, 'Segoe UI', sans-serif;
  --font-body: "Spotify Mix", "Newsreader", system-ui, -apple-system, 'Segoe UI', sans-serif;
  --text-hero: 24px; --weight-hero: 700;
  --text-h2: 18px; --weight-h2: 600; --leading-h2: 23px;
  --text-body: 14px; --weight-body: 400; --leading-body: 19px;
  --text-small: 12px; --weight-small: 400;
  --text-eyebrow: 14px; --weight-eyebrow: 600; --tracking-eyebrow: 1.4px;
  --radius: 0px;
  --radius-button: 9999px;
  --radius-card: 6px;
  --radius-pill: 9999px;
  --radius-sharp: 2px;
  --shadow-card: rgba(0, 0, 0, 0.3) 0px 8px 8px 0px;
  --shadow-overlay: rgba(0, 0, 0, 0.5) 0px 8px 24px 0px;
  --focus-ring: 1px solid rgb(0, 0, 0);
  --ease: cubic-bezier(0.3, 0, 0, 1);
  --duration-fast: 150ms;
  --duration-base: 200ms;
  --duration-slow: 250ms;
  --section-y: 40px;
}

/* their own tokens, verbatim from the site's :root */
:root {
  --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;
}
/* fonts: Spotify Mix may be proprietary — safe free fallback: Newsreader (Google Fonts). */