---
version: alpha
name: Shopify
description: Light design system extracted from shopify.dev (DOM-true values, Emblematic extractor 0.2.0, 2026-11-17).
colors:
  background: "#FFFFFF"
  on-surface-variant: "#44474A"
  surface: "#F6F6F7"
  on-surface: "#202223"
  primary: "#475F91"
  outline: "#D2D5D8"
  grayscale-11: "#6D7175"
  grayscale-15: "#000000"
  background-dark: "#0D1213"
  on-surface-dark: "#EEF1F1"
  on-surface-variant-dark: "#D7D7DB"
  surface-dark: "#151D1E"
  primary-dark: "#B5C9FA"
  outline-dark: "#24393D"
typography:
  display-lg:
    fontFamily: Inter
    fontSize: 32px
    fontWeight: 600
    lineHeight: 1.25
  title-md:
    fontFamily: Inter
    fontSize: 12px
    fontWeight: 600
    lineHeight: 1.333
    letterSpacing: 0.04em
  body-md:
    fontFamily: Inter
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
  body-sm:
    fontFamily: Inter
    fontSize: 14px
    fontWeight: 400
    lineHeight: 1.429
  mono-md:
    fontFamily: JetBrains Mono
    fontSize: 12px
    fontWeight: 400
    lineHeight: 1.333
rounded:
  sm: 3px
  md: 8px
  full: 9999px
spacing:
  xxs: 2px
  xs: 4px
  sm: 6px
  md: 8px
  lg: 12px
  xl: 16px
  2xl: 28px
  3xl: 40px
  4xl: 60px
  base: 4px
components:
  button-secondary:
    textColor: "{colors.on-surface-variant}"
    rounded: "{rounded.md}"
    padding: 6px
    height: 34px
  card:
    backgroundColor: "#FAFBFB"
    rounded: "{rounded.md}"
    padding: 12px
  input:
    backgroundColor: "#FAFBFB"
    rounded: "{rounded.md}"
    padding: 4px
    height: 32px
---

# Shopify

> Extracted from [https://shopify.dev/docs/api/polaris](https://shopify.dev/docs/api/polaris) on 2026-11-17 by Emblematic. Every value below was read from the rendered DOM (computed styles, `document.fonts`, and the fonts Chrome actually used to paint text), not estimated from pixels. When the YAML front matter and this prose disagree, the YAML wins. Copy values from this file exactly; don't transcribe them from memory. Don't copy logos, imagery, illustrations or marketing copy.

## Overview

Shopify uses a light canvas (#FFFFFF) with a palette led by #475F91. Type is set in **Inter** (display + body), **JetBrains Mono** (mono), with 16px body text. Layout: fluid container, top-sticky navigation, 4 sections. Built with an undetected stack.

## Colors

Area-weighted from painted backgrounds, text and borders on the 1440px light capture. Roles are inferred from usage (largest background, most text, interactive fills). Every hex is an exact computed value; a role marked *unverified* is a best guess that has not passed review, so its canonical token (e.g. `primary`) is left out of the front matter.

| Token | Hex | OKLCH | Role | Share of paint | CSS variable |
|---|---|---|---|---|---|
| `background` | `#FFFFFF` | 1 0 0 | bg | 80.2% | `--Background-Default` |
| `on-surface-variant` | `#44474A` | 0.396 0.006 248 | muted | 7.3% | `--Text-Default` |
| `surface` | `#F6F6F7` | 0.973 0.001 286.4 | surface | 7.2% | `--Background-Surface-Hover` |
| `on-surface` | `#202223` | 0.25 0.004 228.9 | text | 2.0% | `--Text-Bright` |
| `primary` | `#475F91` | 0.489 0.086 264 | accent | 0.77% | `--Text-Link-Default` |
| `outline` | `#D2D5D8` | 0.872 0.005 247.9 | border | 0.30% | `--Border-Default` |
| `grayscale-11` | `#6D7175` | 0.546 0.008 248 | other | 2.0% | `--Grayscale-11` |
| `grayscale-15` | `#000000` | 0 0 0 | other | 0.26% | `--Grayscale-15` |

Sparse chromatic highlights (not accents): `#474F94` (`--Editions-Medallions-Blue`).

Contrast: text on background 15.98:1, muted text 9.35:1, accent 6.34:1.

The site responds to `prefers-color-scheme: dark`; the `-dark` tokens hold the dark-mode roles.

## Typography

| Family | Role | Weights | Share of text | Source |
|---|---|---|---|---|
| **Inter** | display, body | 400, 600 | 100.0% | webfont |
| **JetBrains Mono** | mono | 400 | 0.00% | webfont |

Scale (px): 12, 14, 16, 24, 32. Effective ratio ≈ 1.414 (close to a augmented fourth). Body 16px at line-height 1.5; display 32px with tracking 0em. Headings are upper case. On a 390px viewport the body is 16px and display 24px.

## Layout

Spacing follows a 4px base unit; the most used steps are 2, 4, 6, 8, 12, 16, 28, 40, 60px. Content sits in a fluid container on a 2-column grid. Text density 0.137 (text area / page area).

Section order (desktop). Kinds below the review threshold are shown as *section*:

1. **nav** (48px, bg #FFFFFF)
2. **nav** — “Polaris references” (72px, bg #FFFFFF)
3. **hero** (1395px, bg #FFFFFF)
4. **footer** — “Shopify” (392px, bg #FAFBFB)

## Elevation & Depth

Style: subtle. Most used shadows:

- `rgba(0, 0, 0, 0.1) 0px 1px 0px 0px`
- `rgba(0, 0, 0, 0.2) 0px -2px 0px 0px inset, rgba(255, 255, 255, 0.75) 0px 2px 0px 0px inset`
- `rgba(0, 0, 0, 0.2) 0px 2px 0px 0px inset`

## Shapes

Dominant corner radius 8px; radii in use: 3px, 8px, pill. Borders: hairline (1px).

## Components

- **button-secondary**: textColor `#44474A`, rounded `8px`, padding `6px 8px`, height `34px`, fontFamily `Inter`, fontSize `14px`, fontWeight `400`, border `1px solid #96C6DD`, shadow `rgba(0, 0, 0, 0.2) 0px -2px 0px 0px inset, rgba(255, 255, 255, 0.75) 0px 2px 0px 0px inset` (e.g. “Ask assistant”)
- **card**: rounded `8px`, padding `12px`, backgroundColor `#FAFBFB`, border `1px solid #D2D5D8`, shadow `rgba(0, 0, 0, 0.1) 0px 1px 0px 0px`
- **input**: rounded `8px`, height `32px`, padding `4px 32px`, backgroundColor `#FAFBFB`

## Do's and Don'ts

- Do reserve `#475F91` for primary actions and highlights; it covers only 0.77% of the painted page.
- Do set body copy in Inter at 16px / 1.5.
- Don't introduce font weights beyond 400, 600.
- Do keep corners at 8px for most controls, and use the larger radii only for cards and media.
- Do snap spacing to multiples of 4px.
- Don't copy this site's logos, illustrations, photography or copy; use the system, not the brand assets.

## Provenance

Spec v2, extractor 0.2.0. Render quality: **ok**. Vision pass: not run. Fields below confidence 0.7 are hedged or left out above: `color.accent_strategy`, `components`, `imagery.dominant_colors`, `layout.columns`, `layout.hero`, `layout.section_count`, `space.section_padding_px`. Full per-field provenance is in `spec.json`.
