About Madewell DESIGN.md
Curated by Dov AzencotUpdated Source madewell.com
- E-commerce & Retail
Madewell's storefront makes a claim through photography that no color token can: that the brand's identity is the texture of lived-in denim. The hero is not a campaign photograph of models on location — it is a close-up of indigo-wash fabric, or a candid of someone in well-worn jeans on a downtown street, or a flat lay of a raw-denim trucker jacket against an ecru ground. The typographic system runs lowercase, which is the most visible way the brand distances itself from its J.Crew Group parent: where J.Crew runs headline serifs and spaced small-caps nav links in the tradition of a catalog, Madewell runs lowercase grotesque across every role — nav, headline, body, CTA — communicating that the brand is worn, not presented. The canvas is a warm off-white, one temperature step away from pure white, closer to the undyed cotton of a natural-fiber garment.
This DESIGN.md file packages the storefront into a machine-readable spec written to the Google Labs open format. Inside: 14 color tokens drawn from a warm off-white canvas, pure black ink, and three grades of soft gray; 11 typography tokens built around a single lowercase grotesque family used at weight 400 across every tier with modest size variation; a 3-step radius vocabulary centered on a 4px default with no pill geometry; an 8-step spacing scale anchored on 8px; and 15 component entries covering the full-bleed denim hero, the compact lowercase nav, the 4px-radius primary CTA, the 4-up product merchandising grid, the product tile, the size-swatch picker, the text input, and the footer.
Feed this file to Claude, Cursor, or any AI tool that reads structured design tokens and the agent reproduces Madewell's casual discipline — warm canvas, ink black, lowercase grotesque, 4px CTAs, no accent color, photography-first hierarchy — rather than a generic apparel system with pill buttons and a seasonal accent tint. The one move worth transferring to other DTC brands is the lowercase type treatment as brand register: most apparel brands default to uppercase small-caps for nav and CTAs because it reads as authoritative. Madewell inverts the convention and reads as approachable — the clothing is for wearing, not displaying.
What makes it distinct
- Denim-tonal photography as brand identityindigo-wash textile shots and lived-in-denim styling replace the editorial campaign format of J.Crew, positioning product texture as the visual brand
- Lowercase grotesque voicenav, headlines, and CTAs run lowercase or sentence-case, never uppercase-tracked like most apparel peers; the casual register is a typographic brand decision
- Warm off-white canvasthe background is a warm cream rather than pure white, softening the indigo photography against a surface that reads like natural cotton rather than screen pixels
- Soft 4px CTA radiusthe only geometric break from J.Crew's 0px sibling; a single modest rounding distinguishes the brand's casual register from its parent's editorial austerity
- No declared brand accent colorthe full chromatic identity lives in the denim and textile photography; the chrome runs on ink black and off-white alone
Live at madewell.com
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
madewell.comExplore Madewell
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.
Semantic
Status, errors, success, inline links.
Other
Specialty colors.
Madewell design system FAQ
Common questions about Madewell'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.
Madewell — official site
Madewell's public marketing and e-commerce site — 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.