Make your AI a shadcn expert

MUJI Design System

MUJI's minimal Japanese retail design system as a DESIGN.md file.

About MUJI DESIGN.md

Curated by Dov AzencotUpdated Source muji.com

  • E-commerce & Retail

MUJI's online store is what a 40-year-old Japanese no-brand brand looks like when it refuses every Western e-commerce convention. The page paints warm graphite ink (#3c3c43) on a paper-white canvas (#ffffff) and admits one chromatic accent: the trademark red (#7f0019) that lives in the wordmark chip and a handful of seasonal callouts. Where most global retailers paint primary CTAs in a saturated brand voltage, MUJI uses the red 93 times across the entire homepage — mostly in 1px borders and small text labels — and leaves every primary action button in pale neutral chrome (#ebebec) with graphite ink text. The button doesn't shout; the linen photograph does.

This page packages the storefront into a DESIGN.md file. Inside: 21 color tokens organized into ink, surface, hairline, and a single brand-red layer; 10 typography levels all rendered in Helvetica/Arial at weight 400 and 700 (no medium, no light, no italic); a two-step radius scale that pivots at 2px for cards and 9999px for category chips with nothing in between; an 8px-based spacing rhythm; and 22 component definitions covering the top-nav, primary CTA, product tile, recommendation rail, category chip, hero banner, and packed-cube feature card. The full CSS-variable layer (32 :root tokens including success-mint, danger-rubicund, warning-yellow) is captured even though most of those swatches are dormant on the homepage.

Feed the file to Claude, Cursor, or Copilot and the agent reproduces MUJI's no-brand discipline — Helvetica labels, paper canvas, warm graphite ink, square corners with pill chips, photography-first hero bands — instead of a generic shadcn theme. Every token traces back to the live storefront extraction, every hex sits in the CSS, and the photography-carries-warmth principle is the named constraint a junior agent needs to be told before it starts replacing the red with a brighter pigment.

What makes it distinct

  1. Single-voltage red#7f0019 (the MUJI logo red) appears in 93 occurrences total, 5 as background and 33 as text, never as a primary button fill
  2. One-typeface systemHelvetica/Arial across every label at weight 400 and 700 only, with the lone h2 reaching 37.44px / 40.32px line-height
  3. Two-tier radius2px on cards and tiles (84 occurrences), 9999px pill chips for category badges (212 occurrences), and nothing in between
  4. Warm graphite ink#3c3c43 used 3211 times across text (1744) and borders (1464); the warm tint over pure black is the brand's softness signal
  5. Photography-led catalogueproduct, linen, and packed-cube hero shots carry every emotional moment while the chrome holds at 8px / 12px breathing units

Live at muji.com

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

Screenshot of MUJI's website at muji.commuji.com

Explore MUJI

Pick what you want to see — mockups, colors, typography, layout, or the full component list.

Brand & Accent

Sparing, CTA-only voltage.

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.

MUJI design system FAQ

Common questions about MUJI'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 MUJI in your project

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

Download DESIGN.md