# DESIGN.md: Peloton-style design system

Measured from https://www.onepeloton.com/ on 2026-10-15 by PikSpec (https://www.pikspec.com). An independent measurement of the rendered page, not Peloton's official design system, and not affiliated with Peloton.

Use it to build your own product in this design language: put this file in your project root and tell your AI tool (Claude Code, Cursor, Codex, Lovable, v0) to follow DESIGN.md. Never use the original's name, logo, copy or images; licensed fonts are replaced with the closest free Google Fonts.

To capture any other page, or get a ready project for your tool: https://www.pikspec.com/build-with-ai

HOW IT SHOULD LOOK
Build it in the design language of onepeloton.com, measured from the live site: it should feel designed by the same team as onepeloton.com — the same temperament, colour, type and density — for a different product. Never use onepeloton.com's name, logo, words or images.

Stack: use the one your project already has. Starting fresh: React + Vite + TypeScript + Tailwind CSS v4, with no UI kit (no shadcn/ui, MUI or Chakra) — their defaults would override this system. In a chat that shows one file (an artifact or canvas), build one HTML file instead, with the tokens below in its <style> block.
Use every value exactly as written. Do not round, rename, approximate or substitute a colour, size, radius, shadow or easing (fonts: see section 1). Anything not listed here does not exist in this system.

THE WEBSITE THIS SYSTEM COMES FROM
- Reference page: https://www.onepeloton.com/ — "www.onepeloton.com" (home page).
- Page frame: a top navigation bar and a footer.
- Content is grouped in cards (35 on the page, up to 3 side by side). Keep cards for grouped content only, not for every section.
- It uses 65 images including 2 videos, 27 of them large. Large, real product imagery is part of the look — leave clearly labelled image slots at those sizes rather than stock photos or abstract 3D shapes.
- Interaction: 42 buttons and 1 form field on one page.
- The page runs about 8 screens long at 1440px wide.
- Density is low: few elements per screen, generous space around each one.

HOW IT LOOKS (WHAT MAKES IT LOOK LIKE ITSELF, BEYOND THE VALUES)
- Almost entirely neutral: 100% of the page is painted in #F5F7F9 and #FFFFFF.
- The largest type (48px Inter) is semibold (600), tracked to -0.004em.
- Open: text covers 11% of the page.
- Share of the painted page: #F5F7F9 52.5% (dominant, backgrounds); #FFFFFF 17.9% (dominant, backgrounds); #000000 10.7% (dominant, backgrounds); #181A1D 9.1% (dominant, backgrounds and text); #F7F7F7 7.9% (dominant, backgrounds); #65666A 1.3% (supporting, text); #A8ACB1 0.4% (detail, text); #E4E6E7 0.2% (detail, backgrounds). Keep accents at these proportions; do not promote them to fills.
- Hairline dividers: 1px lines in #E4E6E7 separate sections and rows (4 of them).
- Large images: Photographs, video or raster artwork cover about 94% of the page.
- Type as set (size, weight and tracking measured together; use these pairs): 48px weight 600 tracking -0.004em; 36px weight 600 tracking -0.006em; 32px weight 600 tracking -0.006em; 26px weight 600 tracking -0.008em; 22px weight 400 tracking -0.03em; 18px weight 500.

1. DESIGN TOKENS — PASTE INTO YOUR GLOBAL CSS
Allowed colours, with how the original uses each. Use no other colour, including in hover states:
- #F5F7F9 — 52.5% · backgrounds (var(--color-f5f7f9))
- #FFFFFF — 17.9% · backgrounds (var(--color-surface))
- #000000 — 10.7% · backgrounds (var(--color-000000))
- #181A1D — 9.1% · backgrounds, text (var(--color-text))
- #F7F7F7 — 7.9% · backgrounds (var(--color-background))
- #65666A — 1.3% · text (var(--color-text-muted))
- #A8ACB1 — 0.4% · text
- #E4E6E7 — 0.2% · backgrounds
- #888B93 — hairlines and grid lines
- #E2E8F0 — Border (var(--color-border))
- #DF1C2F — Negative (var(--color-negative))
Fonts — put these first in your global CSS (one import per font, so one that fails cannot stop the others):
```css
@import url("https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap");
```
Inter is on Google Fonts and loaded from there.
Keep every size, weight, line height and tracking exactly as listed whichever font renders.
```css
:root {
  --color-background: #F7F7F7; /* Background */
  --color-surface: #FFFFFF; /* Surface */
  --color-text: #181A1D; /* Text */
  --color-text-muted: #65666A; /* Text muted */
  --color-border: #E2E8F0; /* Border */
  --color-action: #181A1D; /* Action */
  --color-on-action: #FFFFFF; /* On action */
  --color-negative: #DF1C2F; /* Negative */
  --color-f5f7f9: #F5F7F9; /* 52.5% of the page, as fills */
  --color-000000: #000000; /* 10.7% of the page, as fills */
  --font-body: "Inter", sans-serif; /* Inter */
  --type-display-large: 48px; /* Display Large, weight 600 */
  --type-display-large-leading: 62.4px;
  --type-display-large-tracking: -0.004em;
  --type-display-small: 36px; /* Display Small, weight 600 */
  --type-display-small-leading: 46.8px;
  --type-display-small-tracking: -0.006em;
  --type-headline-large: 32px; /* Headline Large, weight 600 */
  --type-headline-large-leading: 41.6px;
  --type-headline-large-tracking: -0.006em;
  --type-headline-small: 26px; /* Headline Small, weight 600 */
  --type-headline-small-leading: 33.8px;
  --type-headline-small-tracking: -0.008em;
  --type-title-large: 22px; /* Title Large, weight 400 */
  --type-title-large-leading: 28.6px;
  --type-title-large-tracking: -0.03em;
  --type-title-small: 18px; /* Title Small, weight 500 */
  --type-title-small-leading: 23.4px;
  --type-body-large: 16px; /* Body Large, weight 400 */
  --type-body-large-leading: 24px;
  --type-body-medium: 15px; /* Body Medium, weight 600 */
  --type-body-medium-leading: 20.8px;
  --type-body-small: 14px; /* Body Small, weight 400 */
  --type-body-small-leading: normal;
  --type-label-large: 13px; /* Label Large, weight 300 */
  --type-label-large-leading: 24px;
  --type-label-medium: 12px; /* Label Medium, weight 400 */
  --type-label-medium-leading: 15.996px;
  --type-label-small: 11px; /* Label Small, weight 300 */
  --type-label-small-leading: normal;
  --space-1: 4px;
  --space-2: 8px;
  --space-3: 12px;
  --space-4: 16px;
  --space-5: 20px;
  --space-6: 24px;
  --space-8: 32px;
  --space-9: 36px;
  --space-10: 40px;
  --space-12: 48px;
  --space-14: 56px;
  --space-15: 60px;
  --space-16: 64px;
  --space-20: 80px;
  --space-22: 88px;
  --radius-xs: 2px;
  --radius-sm: 3px;
  --radius-md: 4px;
  --radius-lg: 5px;
  --radius-xl: 6px;
  --radius-2xl: 8px;
  --radius-3xl: 12px;
  --radius-full: 9999px;
  --radius-16: 16px; /* component radius */
  --radius-28: 28px; /* component radius */
  --radius-40: 40px; /* component radius */
  --elevation-1: rgba(0, 0, 0, 0.04) 0px 4px 8px 0px;
  --elevation-2: rgba(0, 0, 0, 0.14) 3px 10px 15px -5px;
  --elevation-3: rgba(0, 0, 0, 0.05) 0px 16px 40px 4px;
  --duration-1: 0.05s;
  --duration-2: 0.1s;
  --duration-3: 0.15s;
  --duration-4: 0.2s;
  --duration-5: 0.25s;
  --duration-6: 0.3s;
  --duration-7: 0.4s;
  --duration-8: 1s;
  --ease-1: ease-out;
  --ease-2: ease-in-out;
  --ease-3: linear;
}
```
Tailwind CSS v4 (the default for new projects): put this after `@import "tailwindcss";`. It removes Tailwind's own palette, so only these colours exist as utilities:
```css
@theme {
  --color-*: initial;
  --color-background: #F7F7F7;
  --color-surface: #FFFFFF;
  --color-text: #181A1D;
  --color-text-muted: #65666A;
  --color-border: #E2E8F0;
  --color-action: #181A1D;
  --color-on-action: #FFFFFF;
  --color-negative: #DF1C2F;
  --color-f5f7f9: #F5F7F9;
  --color-000000: #000000;
  --font-body: "Inter", sans-serif;
  --text-display-large: 48px;
  --text-display-large--line-height: 62.4px;
  --text-display-large--letter-spacing: -0.004em;
  --text-display-small: 36px;
  --text-display-small--line-height: 46.8px;
  --text-display-small--letter-spacing: -0.006em;
  --text-headline-large: 32px;
  --text-headline-large--line-height: 41.6px;
  --text-headline-large--letter-spacing: -0.006em;
  --text-headline-small: 26px;
  --text-headline-small--line-height: 33.8px;
  --text-headline-small--letter-spacing: -0.008em;
  --text-title-large: 22px;
  --text-title-large--line-height: 28.6px;
  --text-title-large--letter-spacing: -0.03em;
  --text-title-small: 18px;
  --text-title-small--line-height: 23.4px;
  --text-body-large: 16px;
  --text-body-large--line-height: 24px;
  --text-body-medium: 15px;
  --text-body-medium--line-height: 20.8px;
  --text-body-small: 14px;
  --text-label-large: 13px;
  --text-label-large--line-height: 24px;
  --text-label-medium: 12px;
  --text-label-medium--line-height: 15.996px;
  --text-label-small: 11px;
  --radius-xs: 2px;
  --radius-sm: 3px;
  --radius-md: 4px;
  --radius-lg: 5px;
  --radius-xl: 6px;
  --radius-2xl: 8px;
  --radius-3xl: 12px;
  --radius-full: 9999px;
  --shadow-e1: rgba(0, 0, 0, 0.04) 0px 4px 8px 0px;
  --shadow-e2: rgba(0, 0, 0, 0.14) 3px 10px 15px -5px;
  --shadow-e3: rgba(0, 0, 0, 0.05) 0px 16px 40px 4px;
  --ease-1: ease-out;
  --ease-2: ease-in-out;
  --ease-3: linear;
}
```
Tailwind CSS v3 only: extend the theme with these instead, and use no other palette:
```js
// tailwind.config — theme.extend
{
  colors: { "background": "var(--color-background)", "surface": "var(--color-surface)", "text": "var(--color-text)", "text-muted": "var(--color-text-muted)", "border": "var(--color-border)", "action": "var(--color-action)", "on-action": "var(--color-on-action)", "negative": "var(--color-negative)" },
  fontFamily: { "body": ["var(--font-body)"] },
  borderRadius: { "xs": "var(--radius-xs)", "sm": "var(--radius-sm)", "md": "var(--radius-md)", "lg": "var(--radius-lg)", "xl": "var(--radius-xl)", "2xl": "var(--radius-2xl)", "3xl": "var(--radius-3xl)", "full": "var(--radius-full)" },
  boxShadow: { "e1": "var(--elevation-1)", "e2": "var(--elevation-2)", "e3": "var(--elevation-3)" },
}
```

2. BASE STYLES
```css
html { background: var(--color-background); }
body { margin: 0; font-family: var(--font-body); font-size: var(--type-body-large); line-height: var(--type-body-large-leading); color: var(--color-text); -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; }
h1, h2, h3 { font-family: var(--font-body); margin: 0; }
a { color: inherit; }
:focus-visible { outline: 2px solid var(--color-action); outline-offset: 2px; }
```

3. COMPONENTS — MATCH THESE EXACTLY
```css
.link-3 { /* Strong */
  background: transparent;
  color: var(--color-text);
  font-family: var(--font-body);
  font-size: var(--type-body-small);
  font-weight: 600;
  line-height: 19.6px;
  /* recorded states: hover, focus */
}
.card { /* Default */
  background: var(--color-surface);
  border-radius: var(--radius-16);
  min-height: 477px;
  box-shadow: var(--elevation-3);
  color: var(--color-text);
  font-family: var(--font-body);
  font-size: var(--type-body-large);
  font-weight: 300;
  line-height: 27px;
}
.card-2 { /* Alternative 1 */
  background: var(--color-surface);
  border-radius: var(--radius-lg);
  padding: 40px 20px 40px 20px;
  min-height: 393px;
  color: var(--color-text);
  font-family: var(--font-body);
  font-size: var(--type-body-large);
  font-weight: 300;
  line-height: 27px;
}
.card-3 { /* Alternative 2 */
  background: var(--color-surface);
  border: 1px solid #65666A;
  border-radius: var(--radius-md);
  min-height: 55px;
  color: var(--color-000000);
  font-family: var(--font-body);
  font-size: var(--type-body-large);
  font-weight: 400;
  /* recorded states: hover */
}
.button { /* Primary */
  background: var(--color-action);
  border-radius: var(--radius-28);
  padding: 18px 24px 18px 24px;
  min-height: 53px;
  color: var(--color-on-action);
  font-family: var(--font-body);
  font-size: var(--type-body-small);
  font-weight: 600;
  /* recorded states: focus, hover */
}
.button-2 { /* Secondary */
  background: var(--color-action);
  padding: 18px 24px 18px 24px;
  min-height: 55px;
  color: var(--color-on-action);
  font-family: var(--font-body);
  font-size: var(--type-body-small);
  font-weight: 600;
  /* recorded states: checked, focus, hover */
}
.button-3 { /* Secondary 2 */
  background: #65666A;
  border-radius: 50%;
  min-height: 40px;
  color: var(--color-text);
  font-family: var(--font-body);
  font-size: var(--type-body-large);
  font-weight: 400;
  /* recorded states: hover, focus, focus-visible */
}
.nav-2 { /* Alternative 1 */
  background: transparent;
  border-radius: var(--radius-40);
  padding: var(--space-1);
  min-height: 42px;
  color: var(--color-text);
  font-family: var(--font-body);
  font-size: var(--type-body-large);
  font-weight: 300;
  line-height: 27px;
}
.input { /* Default */
  background: var(--color-surface);
  border: 1px solid #888B93;
  border-radius: var(--radius-xs);
  padding: 14px 12px 0px 12px;
  min-height: 50px;
  color: var(--color-text);
  font-family: var(--font-body);
  font-size: var(--type-body-small);
  font-weight: 400;
  line-height: 21px;
  /* recorded states: active, focus, disabled */
}
```
Where a component lists recorded states, write those states using only the colours above; the capture saw that the state exists, not its values. Never invent a state colour.

4. PAGE COMPOSITION
- Light interface on #F7F7F7. Keep that ground; do not add a dark mode.
- The opening screen carries a large image or video behind or across the heading. Leave a [content: hero image or video] slot there, at least half the screen wide; the opening is not text alone.
- Sections change ground between Text (#181A1D) and Surface (#FFFFFF); use only those.
- #181A1D is the action colour. Fill the primary action with it and little else — at most one #181A1D-filled element per screen; other accents keep to the uses listed above.
- Type: Inter for body. Hierarchy comes from size and weight, not colour or decoration.
- Everything sits on a 4px grid.
- Corner radii are 2px, 3px, 4px, 5px, 6px, 8px, 12px, fully round (pill) — nothing else.
- Body text uses Inter at around 16px, weights 300, 400, 500, 600, 700.
- Headings use the same family as body text; the largest heading is 48px.
- Primary buttons are #181A1D, 28px radius, weight 600.
- Cards use 16px corners with a soft shadow.
- Corner radii in use: 6px, 4px, 8px, 19px, 28px.

HOW THE ORIGINAL PACES ITS PAGE (BORROW THE RHYTHM — THE OPENING, THE COLOURED BANDS, THE CARD GRIDS — NOT THE LIST; BUILD THE SECTIONS YOUR PRODUCT NEEDS)
1. Hero — 852px tall, centred 48px heading (weight 600) set mid-band, image behind the content, on #F7F7F7.
2. Cards — 710px tall, split 6 / 3 / 3, 24px gap, left-aligned 32px heading (weight 600), on #F5F7F9.
3. Statement — 286px tall, centred 36px heading (weight 600), on #F5F7F9.
4. Full-bleed image — 680px tall, image behind the content, on #F5F7F9.
5. Statement — 271px tall, centred 36px heading (weight 600), on #F5F7F9.
6. Text — 475px tall, a strip of 33 small items (logos, links or icons), left-aligned 16px heading (weight 500) set low in the band, image on the left, on #F5F7F9.
7. Cards — 918px tall, 4 equal columns, 24px gap, centred 48px heading (weight 600), image behind the content, on #000000.
8. Cards — 828px tall, 3 equal columns, 24px gap, centred 36px heading (weight 600), on #F5F7F9.
9. Cards — 538px tall, 4 equal columns, 12px gap, centred 36px heading (weight 600), on #181A1D.
10. Text — 368px tall, left-aligned 13px heading (weight 300), on #FFFFFF.
11. Footer — 677px tall, split 8 / 4, 60px gap, left-aligned 18px heading (weight 500), on #FFFFFF.
- Content sits in a 1224px container, 108px from the edge at 1440px wide.
- The hero is 852px (0.9 screens): centred 48px heading (weight 600) set mid-band, image behind the content, on #F7F7F7.
- Column splits on a 12-column grid: quarters (2×), 6/3/3, thirds, 8/4; gaps of 24px.
- Headings mix left (4) and centred (6) alignment.
- Sections change background 5 times, between #F7F7F7, #F5F7F9, #000000: colour comes in full-width bands, not in boxes.
- A typical section is about 538px tall.

COPY SHAPE (MATCH THE LENGTH AND CASE; WRITE YOUR OWN WORDS)
- The main heading is 6 words long.
- Section headings are short: typically 1 word.
- Headings are in sentence case (only the first word capitalised).
- The page describes itself in about 23 words; keep your intro paragraph to about that length.

5. MOTION
Interactive elements change colour, background, border and opacity with the measured timing. Animate nothing else.
```css
a, button, [role="button"], input { transition: color var(--duration-1) var(--ease-1), background-color var(--duration-1) var(--ease-1), border-color var(--duration-1) var(--ease-1), opacity var(--duration-1) var(--ease-1); }
@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after { animation-duration: 0.01ms !important; animation-iteration-count: 1 !important; transition-duration: 0.01ms !important; scroll-behavior: auto !important; }
}
```
No scroll-triggered fade-ins, parallax, typewriter text or bouncing elements.

6. RESPONSIVE
- The design was measured at 1440px wide. Lay it out for that width first, then let it reflow down to 360px.
- Content sits in a column at most 1224px wide, centred, with var(--space-4) (16px) side padding on small screens.
- The largest heading scales fluidly: font-size: clamp(26px, 3.3vw, 48px). Every other size stays fixed.
- Break on composition, not device names: a row of columns drops a column when any column would be narrower than 240px; side-by-side splits stack when either side would be narrower than 320px.
- Spacing steps never change between sizes; use smaller steps from the same list where space is tight.
- On touch screens, every link and button has a hit area of at least 44 × 44px without changing its drawn size.

7. ACCESSIBILITY
- Text pairs that pass for body copy: Text on Background (16.3:1), Text muted on Background (5.4:1), Action on Background (16.3:1), Negative on Background (4.5:1), Text on Surface (17.4:1), Text muted on Surface (5.7:1), Action on Surface (17.4:1), Negative on Surface (4.8:1) and On action on Action (17.4:1).
- Use no other text-on-background pairing.
- One h1 per page, headings in order, landmarks (header, nav, main, footer), real buttons and links, a label on every field, alt text on every image, an aria-label on icon-only buttons.
- Every interactive element shows the :focus-visible outline above.

8. DO NOT (THESE ARE WHAT MAKE AI-BUILT SITES LOOK GENERIC)
- No gradients: not in backgrounds, text, buttons or borders. (No gradient was measured.)
- Only these colours: #F5F7F9, #FFFFFF, #000000, #181A1D, #F7F7F7, #65666A, #A8ACB1, #E4E6E7, #888B93, #E2E8F0, #DF1C2F. No new tints, no Tailwind defaults (slate, indigo, violet). (They are every colour that covers a measurable part of the page, and the colours its lines and drawings use.)
- Only the fonts in the tokens: Inter for body. No other typeface, and no Inter, Roboto or system UI font unless it is one of these. (The page is set in Inter; the tokens carry what stands in for them.)
- Headings and large text never heavier than weight 600. Do not make headlines bold to add emphasis. (Every size from 24px up is set at weight 600 or lighter.)
- Large headlines tracked tight (letter-spacing -0.004em), not at the browser default. (The 48px headline is set at -0.004em.)
- No all-caps eyebrow labels above headings. (No uppercase text was measured.)
- No icon above every feature, no emoji, no decorative blobs, sparkles or glows. (None of these is part of the captured design; they are a coding model's defaults.)
- Build the sections your product needs, not the original's list. Give each one this system's look: its kinds of section (hero, cards, statement, image, text, footer), its colours, type, shapes and spacing. (The style carries to any kind of site; the original's page was for a different product.)
- No glassmorphism, backdrop blur, glowing orbs, noise blobs or neon outlines.
- No row of three identical feature cards as the default section. Vary the layout from section to section: a split, a list, a single large statement, a table.
- No centred-everything hero with a pill badge, a gradient headline and two buttons. Lead with the most specific thing about the product.
- No filler copy: no "Unlock your potential", "Revolutionize", "Seamless", "Elevate", "Supercharge", "Next-gen" or lorem ipsum. Write plain, specific sentences a real company would publish.
- No made-up statistics, testimonials or customer logos. Leave a clearly marked [content: …] slot instead.
- No radius larger than the largest one listed.
- No shadows other than the levels listed.
- Do not use onepeloton.com's name, logo, copy or images. This is its design system, not its content.

BEFORE YOU FINISH
- Search your code for every colour, font size, spacing value, radius, shadow and easing, and replace anything that is not a variable above.
- Check that no [content: …] slot has been filled with invented facts.
- Search your CSS for gradient(. There should be none.
- Every colour value in your CSS is one of the allowed colours. Nothing else, including in hover states.
- No text 24px or larger has a font-weight above 600.
- The largest headline uses letter-spacing -0.004em.
- Every section, including ones the original does not have, uses only this system's colours, type, shapes and spacing.
- Content sits in a 1224px container with 108px side margins at 1440px.
- There is no placeholder copy (lorem ipsum, "Feature one", "Your headline here"). Every word is real.
- Take a screenshot at 1440px and put it beside the original. List every difference in colour, weight, spacing, alignment and imagery, and fix each before finishing. Then check 390px wide: nothing scrolls sideways and no heading runs off the screen.