About Aman DESIGN.md
Curated by Dov AzencotUpdated Source aman.com
- Travel & Hospitality
Aman's marketing site operates at a remove from every design-system convention. There is no primary brand color. There is no border radius. There is almost no UI chrome. The page is a sequence of full-bleed resort photographs — thatched pavilions over turquoise water, a tatami room in Tokyo, a courtyard at dusk — separated by narrow editorial headings in a weight-400 serif and small-caps WhitneySSm labels. Where Four Seasons uses deep green as a brand anchor, and Rosewood uses a restrained gold pairing, Aman removes the brand-chrome layer entirely. The page's chromatic voice comes from the photographs; the system's job is to ensure no token competes with them.
The DESIGN.md file packages the system into a machine-readable spec for React and AI coding tools. Inside: 12 color tokens running from charcoal ink (#313131) through a graduated gray family to warm linen (#f3eee7) — no hue anywhere in the palette except the linen's faint warmth; 11 typography tokens spanning Lyon Text Web and WhitneySSm, both at weight 400, with hierarchy delivered through size (from 10px small-caps labels to 31px h2) and letter-spacing (from 0.3px on navigation to 2px on uppercase labels); zero border-radius tokens (the spec uses a single `none: "0px"` value); 8 spacing tokens on a 7px-anchored modular scale; and 15 component definitions covering the sharp-edged reserve button, the whisper-weight nav, the full-bleed editorial section layout, and the photography-led media grid.
Feed this file to Claude or Cursor and it will reproduce Aman's specific register: charcoal over linen instead of black over white, Lyon Text Web only for h2 and h3 editorial moments, WhitneySSm for every functional surface, no rounding anywhere, and letter-spacing doing the work that weight would do in any other luxury system. The move worth borrowing — only if your product has genuinely extraordinary photography — is the willingness to leave the brand-chrome layer empty and let the images do the identity work. Without exceptional photographs, this system reads as an unfinished page.
What makes it distinct
- Zero border radiusnot a single rounded corner appears across the entire captured site; every surface is rectilinear, including the primary CTA button
- Two-serif typographic systemLyon Text Web for editorial headings, WhitneySSm for navigation and labels; both families are weight 400, hierarchy comes from size and letter-spacing alone
- Charcoal not blackthe primary ink is #313131 rather than pure black, a choice that removes visual aggression and keeps the type in harmony with linen tones
- Fractional spacing scalethe page uses 5.6px, 4.2px, and 14px as primary rhythm tokens, suggesting a modular scale anchored on 7px rather than a conventional 4px or 8px grid
- Linen canvas as themeColor#f3eee7, declared in the page meta themeColor, appears as the button text and select background surface — warmer than cream, closer to undyed linen
Live at aman.com
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
aman.comExplore Aman
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.
Aman design system FAQ
Common questions about Aman'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.
Aman — official site
Aman's public marketing 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.