About PUMA DESIGN.md
Curated by Dov AzencotUpdated Source us.puma.com
- E-commerce & Retail
PUMA's US storefront is a study in photographic delegation — the brand trusts product photography to carry every chromatic responsibility and keeps every CSS-rendered surface in a two-tone near-black and white. The hero heading "SHOWTIME" runs in white at 40px FFDINforPuma weight 700 over a gradient-banner that is itself a product composition (shoes in warm orange, pink, and electric blue tones). Scroll past the hero and every section is white canvas with near-black type, light gray hairline borders, and images doing all the emotive work. Where Nike uses a thick white-on-black type treatment with occasional volt yellow accents, and Adidas leans on a blue-threaded nav, PUMA keeps the chrome down to a binary and lets the product photography generate the brand personality per-season.
The DESIGN.md file captures the system into a machine-readable spec for React and AI tools. Inside: 14 color tokens covering the near-black ink and button surface, the white canvas, two gray mids for secondary text and hairlines, and pure black for shadow and hard-border moments; 12 typography tokens running FFDINforPuma from 40px hero h1 through 12px captions — the only two-axis variation being size and weight (400 for body, 700 for headings and CTA labels), with uppercase tracking appearing on navigation links and category headers; 5 radius tokens anchored at 2px; 8 spacing values on a 4px/8px base; and 16 component definitions covering the primary button, ghost button, top nav, hero heading, product card, and category-tab strip.
Feed this file to Claude or Cursor and it will reproduce PUMA's specific moves: near-black fill primary buttons with 2px radius instead of the pill or 8px rounding that most sportswear e-commerce defaults to, all-caps uppercase nav links with 0.32px tracking, and white canvas sections where the only non-neutral element is a product image. The most transferable lesson from this system is the discipline of zero brand-chrome color — it means the palette never clashes with seasonal product colorways, which in sportswear change every six to eight weeks.
What makes it distinct
- Photography-voltage systembrand color is absent from the chrome; every chromatic moment on the page comes from product images, not CSS fills
- FFDINforPuma at condensed weight 700the custom DIN variant drives every heading tier, with uppercase + 0.32px tracking on nav links and category labels as the sole typographic accent
- 2px default radiusbuttons, inputs, and cards all sit at 2px, placing PUMA closer to sharp-edge fashion brands (Zara, Supreme) than to the pill-first Nike or Adidas
- Absolute binary palettenear-black (#191919) and white (#ffffff) carry 339 of the 416 total color occurrences; mid-gray hairlines handle the rest
- Product-only colorthe hero gradient is generated by product imagery (shoes in orange-pink-blue tones); the page chrome contributes zero chromatic pixels
Live at us.puma.com
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
us.puma.comExplore PUMA
Pick what you want to see — mockups, colors, typography, layout, or the full component list.
Surface
Page and card backgrounds.
Text
Headlines, body, captions, muted.
Borders & Hairlines
Dividers, outlines, structural rules.
Other
Specialty colors.
PUMA design system FAQ
Common questions about PUMA's tokens, components, and how to use this DESIGN.md in your project.
Related reading
Specs, directories, and component libraries that pair with this design system.
Browse all design systems
The full directory of DESIGN.md files on shadcn.io, with live mockups for each.
PUMA — official site
PUMA's public US storefront — the source of truth for the live tokens captured in this file.
The DESIGN.md specification
Google Labs' open spec for machine-readable design system files — the format this page is built on.