Internal · design foundation

Design System

Warm neutrals, linen surfaces, Rose Medallion–inspired editorial luxury cues, and coaching language that explains why. Not linked in primary navigation — foundation work parallel to gameplay truth.

Internal foundation page. Preview tokens, tactile tiles, CoachBubble variants, achievements, and table surfaces. BYOC-first posture is unchanged; no payments, tournaments, or multiplayer.

Emotional direction — hero: Feel invited, not sold to; curiosity over hype.. Tile and mat themes honor collectible physical sets — lifestyle tabletop with salon stationery restraint.

Token snapshot

Single export mahjongDesignTokens — colors, typography, radii, spacing, shadows, motion, tile metrics, and table surfaces.

Ivory / linen
#fffaf4 · #ebe3d7
Felt / ink
#b8c4a8 · #2c231c
Motion
280ms · cubic-bezier(0.22, 1, 0.36, 1)
Tile comfort size
48×64px

Luxury tile & mat themes

Phase 9 vocabulary — stitched mats and layered tile finishes that mirror boutique clubs and heirloom racks. Full gallery also lives on the internal /table-aesthetic route.

MatSurface sample

Default linen felt preset

Children slot inside the stitched rim — Play uses the same shell for the guided rehearsal tableau.

Tile themes

Collectible surfaces — bone porcelain, mineral jade, lucite clarity, linen neutrals, and matte graphite. Each id pairs with Tile via tileThemeId and premium.

Classic ivory

Polished bone porcelain with a whisper of beeswax.

Warm bone-china calm — the default heirloom handshake between hand and tile.

Emotional goal — Trustworthy tradition — like tiles passed down through your club.

5●dots
8‖bams
Ewind
Gdragon
Jjoker

Vintage jade

Cool jade glass kissed by attic sunlight.

Mineral depth with quiet dignity — collectible sets that age beautifully.

Emotional goal — Grounded confidence — every draw feels considered.

5●dots
8‖bams
Ewind
Gdragon
Jjoker

Lucite bloom

Clear resin bloom with soft inner frost.

Contemporary clarity — garden-party lucite without loud plastics.

Emotional goal — Celebratory lightness — floral accents without kitsch.

5●dots
8‖bams
Ewind
Gdragon
Jjoker

Hamptons linen

Bleached linen over pale oat plaster.

Sun-washed neutrals — coastal clubhouse linen folded beside the rack.

Emotional goal — Effortless hospitality — the table feels open-air and gracious.

5●dots
8‖bams
Ewind
Gdragon
Jjoker

Modern noir

Soft-touch graphite with brushed charcoal rims.

Matte graphite discipline — gallery-quiet contrast for evening sessions.

Emotional goal — Focused silhouette — evening table calm without harsh glare.

5●dots
8‖bams
Ewind
Gdragon
Jjoker

Rose medallion study

Eggshell china with famille coral bloom and celadon rim light — collectible salon tiles.

Blush porcelain abstraction — medallion warmth translated into gradients and gold dust, never illustrative blooms.

Emotional goal — Collectible salon pride — dinner-party tabletop gravitas without fuss.

5●dots
8‖bams
Ewind
Gdragon
Jjoker

Porcelain blossom

Pressed stationery porcelain kissed by garden humidity.

Floral ivory calm — stationery-soft washes paired with turquoise whispers for social daylight tables.

Emotional goal — Quiet exuberance — like unfolding bespoke stationery before guests arrive.

5●dots
8‖bams
Ewind
Gdragon
Jjoker

Palm Beach garden

Salt-air linens cooled under pergola shade.

Hostess linen optimism — sunlight coral restrained by sage pathways for luncheon-length Mahjong.

Emotional goal — Effervescent hospitality — gracious pacing between pours of iced tea.

5●dots
8‖bams
Ewind
Gdragon
Jjoker

Mat themes

Tabletop lifestyle washes — stitched rims, linen grain, and warm depth. Pair mats with MatSurface via matThemeId.

Linen felt

Default warm tableau — oat linen over muted meadow felt.

Soft linen rim with double-track ivory stitching.

Emotional goal — Sunday brunch club energy — tactile without fuss.

Garden jade

Courtyard shade — moss and jade wash that flatters ivory or mineral tiles.

Herbaceous border with pale sage whip-stitch.

Emotional goal — Hosted garden table — fresh air without leaving the screen.

Coastal blue

Harbor mist — cool driftwood blues that stay boutique, not nautical kitsch.

Air-spun rim with porcelain chalk stitching.

Emotional goal — Breezy clubhouse porch — light, crisp, composed.

Soft blush

Rose quartz whisper — celebratory without shouting.

Powder hem with champagne thread.

Emotional goal — Hostess glow — tiles feel gift-wrapped for the table.

Evening noir

Deep velvet dusk — lamp-lit sessions with gallery contrast.

Ink velvet surround with antique brass stitch glow.

Emotional goal — Lamp-lit focus — drama without theatrics.

Rose salon

Salon linen blush — Palm Beach luncheon mats translated into layered ivory with whisper coral bloom ghosts.

Porcelain deckle rim with brass-gold whip-stitch and turquoise chalk echoes.

Emotional goal — Invite-only tabletop elegance — guests linger without crowded visuals.

Jade parlor

Courtyard jade editorial — mineral greens cooled over blush undertones for collectible porcelain tiles.

Double-track celadon stitching over flax linen with coral reserve ghosts.

Emotional goal — Garden-parlor calm — mineral clarity without spa cliché.

Coral linen

Sunlit coral restraint — faded famille warmth folded into oat linen for daytime club hosting.

Luncheon linen surround with coral stitch and gold chalk punctuation.

Emotional goal — Effortless hostess polish — sunlight social tables.

Rose Medallion editorial inspiration

Jewel-toned blush porcelain, lacquer coral punctuation, celadon reserves, and stationery gold — collectible tabletop culture via gradients and disciplined frames, not literal patterns. Deeper rationale lives in docs/ROSE_MEDALLION_DIRECTION.md; isolated preview at /rose-medallion.

Abstract palette — tokens only

warmIvory

#fff8f3

lacquerCoral

#d46559

celadonJade

#6fa795

turquoisePorcelain

#4dad9f

warmGold

#d4af61

lacquerBerry

#a32e37

blushPorcelain

#f9f1ec

mutedTurquoise

#5aa896

Typography posture

  • Serif-forward headings with crisp rhythm — editorial stationery, not historical revival. Prefer moderate contrast and generous line-height.
  • Warm sans body copy with restrained optical size jumps — readability beats flourish.
  • Avoid ornamental ligatures stacks or distressed textures — luxury reads clean.
Editorial restraint reads as luxury — florals stay atmospheric, never illustrative.

Motifs & textures

  • Think medallion as radial symmetry hint — whisper-soft vignettes at corners, never illustrative blossoms.
  • Four-corner radial fades ≤7% opacity; asymmetry allowed — avoids wallpaper repeat.
  • If florals read clearly from arm's length, reduce opacity — collectible tabletop, not scrapbooking.
Texture snippet preview — porcelain grain + salon bloom ghosts composited at low opacity in mats/tiles.

Tile themes · salon porcelain lane

Rose medallion study

Blush porcelain abstraction — medallion warmth translated into gradients and gold dust, never illustrative blooms.

5●dots
8‖bams
Ewind

Porcelain blossom

Floral ivory calm — stationery-soft washes paired with turquoise whispers for social daylight tables.

5●dots
8‖bams
Ewind

Palm Beach garden

Hostess linen optimism — sunlight coral restrained by sage pathways for luncheon-length Mahjong.

5●dots
8‖bams
Ewind

Mat themes · luncheon-length hosting

Rose salon

Invite-only tabletop elegance — guests linger without crowded visuals.

Salon linen blush — Palm Beach luncheon mats translated into layered ivory with whisper coral bloom ghosts.

Porcelain deckle rim with brass-gold whip-stitch and turquoise chalk echoes.

Jade parlor

Garden-parlor calm — mineral clarity without spa cliché.

Courtyard jade editorial — mineral greens cooled over blush undertones for collectible porcelain tiles.

Double-track celadon stitching over flax linen with coral reserve ghosts.

Coral linen

Effortless hostess polish — sunlight social tables.

Sunlit coral restraint — faded famille warmth folded into oat linen for daytime club hosting.

Luncheon linen surround with coral stitch and gold chalk punctuation.

Do / do not

Lean in

  • Blush ivory reserves with jade + coral undertones — collectible tabletop culture.
  • Gold hairlines as punctuation, not frames everywhere.
  • Palm Beach hostess pacing — daylight optimism without pastel overload.

Avoid

  • Literal famille rose illustration kitsch — abstraction only.
  • Loud lacquer fields — accents whisper.
  • Busy floral noise or arcade-grade chroma spikes.

Tile interaction tokens

Selected / suggested / caution preview — meanings stay advisory (6 states).

Tile tray · tactile preview

States are illustrative
5●dots
default
8‖bams
caution
2万craks
selected
Ewind
default
Gdragon
suggested
Jjoker
default

First Charleston survived

Earned

You kept tempo kind — Charleston is social choreography.

Flexible doubles eye

Next focus

Practice spotting doubles that still leave an escape lane.

Mahjong whisperer

Locked

Arrives when advanced summaries ship — no rush.

Beginner path calm pace

Progress is intentionally gentle — fewer spikes, more rituals.

TableSurface container

Felt gradient, rim light, and inset mat for lesson or replay hosts.

Drop children here for lessons, coach overlays, or tactile previews. Game truth remains elsewhere.

Authoritative documentation lives in docs/DESIGN_SYSTEM.md and docs/COACHING_LANGUAGE.md at the repository root.