Make your AI a shadcn expert

West Elm Design System

West Elm's marketing-site design system as a DESIGN.md file.

About West Elm DESIGN.md

Curated by Dov AzencotUpdated Source westelm.com

  • E-commerce & Retail

West Elm's marketing surface inverts the convention for category-leading home-furnishing retail. Where Wayfair and Article paint their landing pages with chromatic chips, sale badges, and saturated category tiles, West Elm runs an editorial layout that looks closer to a printed Kinfolk spread than to a Williams-Sonoma-owned commerce funnel. The hero is a serif headline in Sanomat at 48px in weight 300 set over a wide photograph of a styled living room — walnut credenza, cream upholstery, a single ceramic vase — and a small near-black pill CTA beneath. Every other chromatic moment on the page comes from the room photography itself: warm cream walls, oak floors, oat textiles, a single hit of olive on a planter. The brand chrome ships no accent colors at all.

The DESIGN.md file packages the system into a machine-readable spec for React tooling. Inside: 15 color tokens drawn from graphite ink, warm-canvas neutrals, and an emergency-red error token that never appears in the hero band; 12 typography tokens across two families — Sanomat (a Schick Toikka serif licensed for editorial display) running 20-48px in weight 300 only, and GT Eesti Text carrying body at 12-18px in weight 300 plus all uppercase nav labels and chips in weight 375 with 0.96-1.6px tracking; 4 radius tokens that almost all resolve to 0px; 8 spacing values on a 4px base; and 18 component definitions covering the black-pill primary button, the zero-radius email input, the hero serif heading, the uppercase nav rail, and the editorial-photography card grid.

Feed this file to Claude or Cursor and it will reproduce West Elm's specific moves: serif display in weight 300 instead of bold sans, zero-radius chrome instead of soft rounding, graphite ink instead of pure black, and uppercase tracked sans labels carrying every nav and chip. The token references resolve without invention. One move worth borrowing only if your category permits editorial photography over product grids: the willingness to let room-shot warmth do every chromatic job, leaving the brand chrome as pure typographic restraint.

What makes it distinct

  1. Serif display over sans bodySanomat at 48px / weight 300 carries every hero headline; GT Eesti Text in weight 300/375 handles body, nav, and uppercase chips
  2. Zero-radius chromeevery button, input, and modal corner sits at 0px; the only round element on the page is the search-magnifier icon
  3. Near-black, not blackprimary ink is graphite #212121 (frequency 948); pure #000000 appears only inside the email-capture modal body text
  4. Editorial photography as paletteroom-shot warm-walnut, cream, and oat tones do every chromatic job; the brand chrome itself ships zero accent colors
  5. Uppercase nav labels in weight 375GT Eesti Text at 12-16px with 0.96-1.6px tracking renders category links as small-caps, never bold sans

Live at westelm.com

A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.

Screenshot of West Elm's website at westelm.comwestelm.com

Explore West Elm

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.

West Elm design system FAQ

Common questions about West Elm's tokens, components, and how to use this DESIGN.md in your project.

Specs, directories, and component libraries that pair with this design system.

Use West Elm in your project

One machine-readable file. Drop it into Claude, Cursor, or any AI tool that reads DESIGN.md.

Download DESIGN.md