DESIGN.md · Analysis

IZANAMI

izanami-official.com · 20 Jul 2026 · 47 colors · Playfair Display, Cinzel

IZANAMI

A Japanese-inspired design system centered on the philosophy of Wa (harmony). IZANAMI guides users through School, Craft, and Retreat with a refined, minimalist aesthetic rooted in traditional Japanese sensibilities and contemporary digital craft.

Colors

surface#0a0801
surface-dim#050400
surface-bright#1a1812
surface-container-lowest#000000
surface-container-low#0f0d0a
surface-container#0a0801
surface-container-high#151310
surface-container-highest#1f1b17
on-surface#d9d7d4
on-surface-variant#a8a5a0
inverse-surface#d9d7d4
inverse-on-surface#0a0801
outline#7a7773
outline-variant#4a4743
surface-tint#caa100
primary#caa100
on-primary#0a0801
primary-container#e6c547
on-primary-container#3d3200
inverse-primary#caa100
secondary#d9d7d4
on-secondary#0a0801
secondary-container#e9ecef
on-secondary-container#2a2622
tertiary#a8a5a0
on-tertiary#0a0801
tertiary-container#c4c1bc
on-tertiary-container#1f1b17
error#ffb4ab
on-error#690005
error-container#93000a
on-error-container#ffb4ab
primary-fixed#e6c547
primary-fixed-dim#caa100
on-primary-fixed#3d3200
on-primary-fixed-variant#8a7500
secondary-fixed#e9ecef
secondary-fixed-dim#d9d7d4
on-secondary-fixed#2a2622
on-secondary-fixed-variant#5a5652
tertiary-fixed#c4c1bc
tertiary-fixed-dim#a8a5a0
on-tertiary-fixed#1f1b17
on-tertiary-fixed-variant#6a6662
background#0a0801
on-background#d9d7d4
surface-variant#4a4743

Typography

display
fontFamily: Playfair Display · fontSize: 72px · fontWeight: 400 · lineHeight: 84px · letterSpacing: -0.03em
headline-lg
fontFamily: Playfair Display · fontSize: 48px · fontWeight: 400 · lineHeight: 56px · letterSpacing: -0.02em
headline-md
fontFamily: Cinzel · fontSize: 32px · fontWeight: 400 · lineHeight: 40px · letterSpacing: 0.02em
title-lg
fontFamily: Cinzel · fontSize: 24px · fontWeight: 400 · lineHeight: 32px · letterSpacing: 0.01em
body-lg
fontFamily: Helvetica Neue · fontSize: 18px · fontWeight: 400 · lineHeight: 28px · letterSpacing: 0em
body-md
fontFamily: Helvetica Neue · fontSize: 16px · fontWeight: 400 · lineHeight: 24px · letterSpacing: 0em
label-md
fontFamily: Helvetica Neue · fontSize: 14px · fontWeight: 400 · lineHeight: 20px · letterSpacing: 0.02em
label-sm
fontFamily: Helvetica Neue · fontSize: 12px · fontWeight: 400 · lineHeight: 16px · letterSpacing: 0.03em

Design guidance

Overview

IZANAMI embodies the Japanese philosophy of Wa—the pursuit of harmony through balance, restraint, and intentional design. The brand serves individuals and communities seeking to reconnect with timeless principles of craft, contemplation, and belonging. The aesthetic is rooted in Architectural Minimalism with Zen influences: a near-black canvas (#0a0801) punctuated by a warm, earthy gold accent (#caa100) that evokes both tradition and refinement. The UI evokes a sense of calm clarity—like stepping into a carefully curated tea room where every element has purpose and nothing is superfluous.

The voice is meditative yet precise, never rushed or casual. Sentences are spare and weighted with meaning. Vocabulary draws from Japanese aesthetics (ma, yohaku no bi, shibui) and contemporary craft language. The brand speaks to the user as a fellow seeker, not a consumer. Example: 'Harmony is not something to be created—it is something to be remembered.'

Colors

The color system centers on a profound dark foundation (#0a0801 surface, #050400 surface-dim) that grounds the entire experience in contemplation and focus. Against this near-black canvas, the primary accent—a warm, muted gold (#caa100)—functions as the sole chromatic voice, reserved exclusively for interactive elements, CTAs, and moments of emphasis. This restraint is intentional: the gold appears sparingly, making each interaction feel deliberate and valued. Secondary colors are tonal neutrals: off-white (#d9d7d4) for body text and secondary surfaces, mid-gray (#a8a5a0) for tertiary information, and a graduated surface stack (surface-container-low #0f0d0a through surface-container-highest #1f1b17) that provides subtle depth without visual noise. The outline-variant (#4a4743) is used for

Typography

The type system reflects a hierarchy of contemplation: display-level headlines use Playfair Display (72px, 400 weight, -0.03em tracking) for hero moments that demand presence without aggression; headline-md shifts to Cinzel (32px, 0.02em tracking) for section titles, introducing a subtle serif formality that nods to Japanese typography traditions. Body copy relies on Helvetica Neue (16px, 400 weight, 24px line-height) for legibility and neutrality—a workhorse that recedes and lets content breathe. Labels and UI text use the same Helvetica at 14px with 0.02em tracking to maintain consistency. All type is left-aligned and uses generous line-height (1.5 to 1.75) to create visual rest. Apply text-shadow: 0 2px 4px rgba(0, 0, 0, 0.15) on small labels (12px) when placed over textured backgrounds

Layout

The layout operates on a 12-column grid with a maximum container width of 1280px, allowing content to breathe on larger screens while maintaining focus. The spacing scale is semantic: gutter (24px) defines horizontal padding on sections, lg spacing (40px) separates major sections, and md spacing (24px) creates breathing room between components. The design favors asymmetry and white space (ma—the Japanese concept of meaningful emptiness) over symmetry; content often anchors to the left or right edge with substantial void on the opposite side. Vertical rhythm is strict: all margins and padding are multiples of 8px (the unit token). The footer and header are fixed, creating a persistent frame around scrolling content. Container max-width ensures text never exceeds 80 characters per line, main

Elevation & Depth

Depth is conveyed through subtle layering rather than dramatic shadows. The elevation system uses three levels: sm (0 1px 2px rgba(0, 0, 0, 0.12)) for small UI elements like badges and inputs, md (0 3px 8px rgba(0, 0, 0, 0.15)) for cards and modals, and lg (0 8px 24px rgba(0, 0, 0, 0.20)) for floating elements and overlays. Shadows are soft and diffuse, never sharp—they suggest depth without drawing attention. The dark background (#0a0801) means shadows are visible but restrained; they enhance hierarchy without creating visual clutter. Interactive elements (buttons, links) do not use shadows i

Shapes

The shape philosophy is 'Soft-Technical Restraint'—minimal rounding that respects the grid and the eye. Buttons and inputs use a small, consistent border-radius of 0.5rem (8px), just enough to soften hard edges without introducing organic curves. Cards and larger containers use 0.75rem (12px) for a slightly more generous feel. The full (9999px) radius is reserved for badges and avatar-like elements. Dividers and lines are always 1px, never thicker, to maintain visual lightness. The rationale: sharp corners would feel cold and aggressive against the warm gold and dark canvas; excessive rounding

Components

Action Elements Buttons are the primary interaction point and must always include a visible border (1px solid) to define their clickable area. The primary button uses {colors.primary} background with {colors.on-primary} text, 44px height, and 12px 24px padding. On hover, shift to {colors.primary-container} with a smooth 0.3s transition. The secondary button is transparent with a {colors.on-surface} border; on hover, fill the background with {colors.surface-container-high} and change the border to {colors.primary}. Links are underlined with {colors.primary} and shift to {colors.primary-container} on hover—never remove the underline, as it is the primary affordance.

Containers & Surfaces Cards use {colors.surface-container} background with a 1px {colors.outline-variant} border and {

Do's and Don'ts

**Do**

  • Do use the gold accent (#caa100) sparingly—reserve it for primary CTAs, focus states, and moments of emphasis. Overuse dilutes its power.
  • Do maintain strict 8px spacing multiples throughout. This creates visual rhythm and makes the grid predictable for developers.
  • Do pair Playfair Display (display headlines) with Helvetica Neue (body) to create contrast between formal and functional without clashing.
  • Do always include a 1px border on cards, buttons, and inputs—the border is the primary visual affordance against the dark background.
  • Do use the full surface-container stack (lowest through highest) to create subtle depth; avoid jumping directly from surface to surface-container-highest.

**Don't**

  • Don't use bright, saturated colors or gradients. The gold is muted and warm; any accent should follow this restraint.
  • Don't apply shadows to buttons in their default state. Shadows are reserved for elevated surfaces (cards, modals) and hover states.
  • Don't exceed 80 characters per line of body text. Use the container-max-width (1280px) and generous margins to enforce this.
  • Don't round corners excessively. Keep border-radius at 0.5rem (8px) for buttons and 0.75rem (12px) for cards; never exceed 1.5rem unless creating a badge.
  • Don't use system fonts or generic sans-serif fallbacks in display headlines. Always load Playfair Display and Cinzel from Google Fonts to maintain the brand's typographic identity.