Shopify

Overview

Shopify runs two parallel design tracks that share typographic DNA and a single button vocabulary, but diverge in canvas polarity. The marketing track lives on {colors.canvas-night} (#000000) — full-bleed cinematic photography of merchants, giant {typography.display-xxl} headlines in Neue Haas Grotesk Display set at weight 330 (a thin, almost editorial cut), and a single CTA: a white-stroked black pill with the form button-outline-on-dark. The pages read like the spread of a high-end print magazine: lots of black, lots of negative space, photography that doesn't compete with text, and one and only one action per band.

The transactional track flips to {colors.canvas-light} and {colors.canvas-cream} (an off-white that's barely warmer than pure white). Pricing tiers, comparison tables, and signup flows sit on this lighter canvas, with the same pill button system but in inverse polarity (a solid black pill with white text, or a {colors.aloe-10} mint pill for the featured / "Start free trial" tier). The accents — {colors.aloe-10} mint and {colors.pistachio-10} pistachio — show up only on the light track, never on the cinematic dark hero pages.

Typography is split across three families. Neue Haas Grotesk Display at thin weights (330–500) handles every display, headline, and editorial moment — the brand's identity is that thin display cut. Inter Variable at 420–550 weights handles every UI body, button label, caption, and form field — utility text that doesn't fight the display. ui-monospace appears only in code blocks and rare technical eyebrows. Across all three families, the OpenType ss03 stylistic set is enabled — it's the brand's character-level signature, applied universally.

Key Characteristics:

• Two-canvas system: {colors.canvas-night} for cinematic marketing, {colors.canvas-light} / {colors.canvas-cream} for transactional surfaces — never blended.
• Pill-shape ({rounded.pill}) is the only button shape across both tracks; rounded rectangles do not exist for buttons.
• Thin-weight (330) display typography is the signature; {typography.display-xxl} at 96px / weight 330 is the brand's loudest visual.
• Aloe and pistachio greens ({colors.aloe-10}, {colors.pistachio-10}) are reserved for the light track — they signal commerce, growth, transactional success.
• Photography is full-bleed, edge-to-edge, never inset in cards on the cinematic track; merchants and storefront imagery do the heavy visual lifting that gradients and illustrations would do elsewhere.
• The OpenType ss03 stylistic set is enabled across every text role — a character-level unifier that tracks across both tracks.
• Tight letter-spacing on display sizes (2.4px positive tracking on 96px display) gives the thin weight extra optical air.

Colors

Source pages: home (/), /start, /website/builder, /pricing.

Brand & Accent

• Aloe ({colors.aloe-10} — #c1fbd4): The featured-tier and "growth" accent. Used as a pill button background on light surfaces and as a feature-card fill in the pricing comparison band.
• Pistachio ({colors.pistachio-10} — #d4f9e0): Softer than aloe; used as a wide section band fill on the light track to signal a different category of feature without leaving the green family.
• Cool Link Tones ({colors.link-cool-1} #9dabad, {colors.link-cool-2} #9797a2, {colors.link-cool-3} #bdbdca, {colors.link-mint} #99b3ad): Muted footer / tertiary link colors used on dark surfaces to create a quiet hierarchy below the primary white type.

Surface

• Canvas Night ({colors.canvas-night} — #000000): Pure black hero, cinematic feature pages, footer.
• Canvas Night Elevated ({colors.canvas-night-elevated} — #0a0a0a): Cards on cinematic surfaces, video frames.
• Surface Elevated Dark ({colors.surface-elevated-dark} — #1e2c31): Dark teal-shifted surface used on a small subset of dark cards to introduce subtle depth without breaking the black.
• Canvas Light ({colors.canvas-light} — #ffffff): Pricing, signup, comparison tables.
• Canvas Cream ({colors.canvas-cream} — #fbfbf5): Slightly warm off-white used on the pricing-page background canvas — invisibly different from #ffffff but adds editorial warmth.
• Hairline Light ({colors.hairline-light} — #e4e4e7): 1px borders on light cards, table dividers.
• Hairline Dark ({colors.hairline-dark} — #1e2c31): 1px borders on the rare dark cards that have visible chrome.

Shade Ladder

• Shade-30 ({colors.shade-30} — #d4d4d8): Tag / chip background on light, footer hairline on dark.
• Shade-40 ({colors.shade-40} — #a1a1aa): Tertiary text on light, secondary text on dark.
• Shade-50 ({colors.shade-50} — #71717a): Secondary text on light.
• Shade-60 ({colors.shade-60} — #52525b): Tertiary text on light, deep on dark.
• Shade-70 ({colors.shade-70} — #3f3f46): Pressed-state of the primary pill button; deep dark surface accent.

Text

• Ink ({colors.ink} — #000000): All text on light canvas.
• On Primary ({colors.on-primary} — #ffffff): All text on dark canvas + filled-pill labels.

Typography

Font Family

The display tier is Neue Haas Grotesk Display at thin weights (330–500). When unavailable, fall back to Helvetica at light weight, then Arial. The thin-weight cut is the brand — no substitution should default to weight 400+.

The UI tier is Inter Variable at 420–550 — a variable font with sub-weight precision that lets the system span body (420), strong (550), and caption (500) without jumping to heavier tiers. Inter is open-source via Google Fonts.

The code tier is ui-monospace, the system mono — preferred over a webfont mono to avoid unnecessary downloads.

The OpenType ss03 stylistic set is enabled across every role. It alters specific glyph forms (lowercase a, g, single-story numerals) for a slightly more geometric character. Apply via font-feature-settings: "ss03" on the body element or root.

Hierarchy

Principles

• Display thinness is the brand. Always render display sizes at weight 330 — never 400+. The thinness is a deliberate editorial choice that makes the giant size feel quiet.
• Display in NHGD, body in Inter. Don't push body roles up to NHGD; don't push display roles down to Inter.
• Tracking lifts on display. The 96px hero gets +2.4px positive tracking — the thin glyphs need air. At 70px and below, tracking returns to 0.

Note on Font Substitutes

Open substitutes for Neue Haas Grotesk Display: Helvetica Now Display (proprietary) or Inter Display at light weights (open-source) are the closest matches. Avoid Helvetica Neue at default weight — it's too heavy for the brand's thin tier. Inter Variable is open-source via Google Fonts and is the canonical body face — no substitute needed.

Layout

Spacing System

• Base unit: 8px (with denser sub-units 1, 2, 3, 4 for fine work).
• Tokens: {spacing.xxs} 2px · {spacing.xs} 4px · {spacing.sm} 8px · {spacing.md} 12px · {spacing.lg} 16px · {spacing.xl} 24px · {spacing.xxl} 32px · {spacing.huge} 64px.
• Section padding: {spacing.huge} 64–128px on cinematic marketing pages (extreme negative space is the point); collapses to ~48px on transactional pages where density takes priority.
• Card internal padding: {spacing.xxl} 32px on pricing cards; {spacing.xl} 24px on compact tag rows.

Grid & Container

• Cinematic hero pages use a wide max-width container (~1440–1600px) with edge-bleeding photography that escapes the container.
• Pricing collapses through 4-up → 2-up → 1-up tiers based on viewport.
• Body content centers in a ~720–840px reading column on long-form pages.

Whitespace Philosophy

The cinematic track treats whitespace as the brand's most valuable asset — sections often have 128–192px of vertical air between content blocks, with photography filling the rest. The transactional track tightens to ~48–64px between bands because users are scanning, comparing, and acting. The contrast between the two whitespace philosophies is part of the brand voice.

Elevation & Depth

Decorative Depth

On the cinematic track, depth comes from photography — full-bleed merchant imagery layered behind cards, with subtle inset top-edge highlights creating the illusion of light hitting a glass surface. On the light track, the layered tiny-shadow stack (Level 3) produces a soft, paper-like halo around pricing cards — depth without harshness.

Shapes

Border Radius Scale

Photography Geometry

Photography is full-bleed with no border. On cinematic pages it escapes the container entirely; on transactional pages it sits inside {rounded.lg} containers with no shadow. Avatar treatments in customer-logo strips are simple greyscale wordmarks at uniform height (~24–32px), aligned in a single horizontal strip.

Components

Buttons

button-primary-pill — the dominant CTA across the system.

• Background {colors.primary} (black), text {colors.on-primary}, type {typography.body-md}, padding {spacing.md} {spacing.xl} (12px 24px), rounded {rounded.pill} 9999px.
• Pressed state button-primary-pill-pressed: background lifts to {colors.shade-70}.

button-outline-on-dark — the cinematic hero CTA.

• Background {colors.canvas-night} (transparent on the canvas), 2px solid {colors.on-primary} border, text {colors.on-primary}, same pill geometry.

button-outline-on-light — the light-track equivalent.

• Background {colors.canvas-light}, 1px solid {colors.ink} border, text {colors.ink}, same pill geometry.

button-aloe-pill — the featured CTA on pricing pages.

• Background {colors.aloe-10}, text {colors.ink}, same pill geometry. Used for the "Start free trial" tier.

Cards & Containers

card-pricing — the standard tier card on the pricing page.

• Background {colors.canvas-light}, padding {spacing.xxl}, rounded {rounded.lg} 12px, 1px {colors.hairline-light} border. Title in {typography.heading-xl}, price in {typography.display-md}, body in {typography.body-md}, CTA pinned to the bottom as button-primary-pill.

card-pricing-featured — the highlighted pricing tier.

• Background {colors.aloe-10}, otherwise identical to card-pricing. The mint fill (rather than a brand-color border) is the brand's distinctive featured-tier choice.

card-feature-cinematic — feature card on the cinematic track.

• Background {colors.canvas-night-elevated}, text {colors.on-primary}, rounded {rounded.lg}, often with a top-edge inset highlight (Level 1 elevation). Holds full-bleed photography or a single large statement.

card-pistachio-band — wide horizontal band card used to highlight a category of features on the light track.

• Background {colors.pistachio-10}, text {colors.ink}, rounded {rounded.lg} 12px, padding {spacing.xxl}.

card-photo-frame — full-bleed photography container on cinematic pages.

• Background {colors.canvas-night}, padding 0, rounded {rounded.xl} 20px (often top-only). The photo IS the content; no inner padding, no overlay text inside the card.

Inputs & Forms

text-input — standard text input on light surfaces.

• Background {colors.canvas-light}, text {colors.ink}, type {typography.body-md}, padding {spacing.sm}+ {spacing.md} (10px 12px), rounded {rounded.md} 8px, 1px {colors.hairline-light} border.

Navigation

nav-bar-light — top nav on light pages.

• Background {colors.canvas-light}, text {colors.ink}, padding {spacing.lg} {spacing.xl}. Logo wordmark on the left, nav items center, two pill buttons on the right (button-outline-on-light for "Log in", button-primary-pill for "Start free trial").

nav-bar-dark — top nav on cinematic pages.

• Background {colors.canvas-night}, text {colors.on-primary}, otherwise identical structure. Two pill buttons on the right (button-outline-on-dark for both, with the rightmost subtly more prominent via type weight).

Pills, Tags, and Chips

pill-tag-mint — small tag on light surfaces, signaling a feature category.

• Background {colors.aloe-10}, text {colors.ink}, type {typography.eyebrow-cap}, padding {spacing.xs} {spacing.md}, rounded {rounded.pill}.

pill-tag-shade — neutral tag on light surfaces.

• Background {colors.shade-30}, text {colors.ink}, otherwise same shape as pill-tag-mint.

Signature Components

Cinematic Photography Layer — full-bleed merchant photos on the hero. No overlay scrim, no text-on-image; instead, the type sits in clean negative space above or below the photo. The brand treats photography as an editorial spread, not as decoration.

Stacked Tiny Shadows (Level 3 Elevation) — pricing cards on the light track use 4 stacked tiny drop shadows (each 1–8px Y offset, 10% black) to produce a soft, layered paper halo. This is the brand's distinctive depth on light.

link-on-dark — inline link on cinematic pages.

• Color {colors.on-primary}, no underline by default (links rely on context); for tertiary footer links, color shifts to one of the cool muted tones ({colors.link-cool-1} etc.) with a persistent underline.

footer-dark — full-page-width footer on the cinematic track.

• Background {colors.canvas-night}, text {colors.on-primary}, type {typography.caption}, padding {spacing.huge} {spacing.xl}. Contains 4–5 columns of muted-tone link groups, social icons, and a small legal row.

footer-light — equivalent on the transactional track.

• Background {colors.canvas-light}, text {colors.ink}, otherwise same structure.

Do's and Don'ts

Do

• Reserve {colors.aloe-10} and {colors.pistachio-10} for the light track only — they don't appear on cinematic black pages.
• Always use {rounded.pill} for buttons; never {rounded.md} or {rounded.lg}.
• Render display tiers at weight 330; bumping to 400 or 500 breaks the brand's thin-display signature.
• Use full-bleed photography on cinematic pages — let it escape the container.
• Apply font-feature-settings: "ss03" globally; the stylistic set is the brand's typographic signature.
• Pair black canvas with white type and white-stroked outline pills; pair light canvas with black type and filled-black pills.

Don't

• Don't introduce a third canvas color — stick to black or light/cream. Greys, beiges, and blues are not in the system.
• Don't add drop shadows on cinematic dark cards beyond the subtle inset top-highlight; the cinematic track wants flat blackness.
• Don't shrink display tiers below {typography.display-md} (48px) on hero surfaces; below that they read as section heads, not display.
• Don't put aloe / pistachio greens behind type — they're surface fills, not text colors.
• Don't replace the pill shape with a rounded-rectangle button anywhere.

Responsive Behavior

Breakpoints

Touch Targets

• Pill buttons hit ≥ 44×44px on mobile via 12px vertical padding × 16px line-height. WCAG AAA compliant.
• Form fields stay at the 44px minimum height across all breakpoints.

Collapsing Strategy

• Display sizes scale down through the breakpoint stair: 96 → 70 → 55 → 48 → 36px on mobile.
• Cinematic photography crops aggressively at smaller widths, prioritizing focal subject over edge-bleed.
• Pricing tiers stair-step 4-up → 2-up → 1-up; the featured aloe tier stays visually distinguished at every step.
• Top nav collapses to hamburger below 768px; menu inherits canvas polarity.

Image Behavior

Photography uses responsive srcset with art-direction crops at major breakpoints. Mobile crops favor close subjects; wide crops favor environmental / storefront context.

Iteration Guide

1. Focus on ONE component at a time.
2. Reference component names and tokens directly ({colors.aloe-10}, {button-primary-pill}-pressed, {rounded.pill}).
3. Run npx @google/design.md lint DESIGN.md after edits.
4. Add new variants as separate entries.
5. Default body to {typography.body-md}; reserve {typography.body-lg} for marketing leads.
6. Keep the two canvas tracks separated — when designing a new page, choose cinematic OR transactional, not both.
7. The pill shape is non-negotiable; new button variants vary in fill / border / canvas, never in shape.