Specification & Interactive Verification

Swiss Minimalist Design System

Architectural Rigor + Organic Warmth + Silent Motion. Built for Next.js 16, Tailwind CSS v4, and WCAG 2.2 AAA accessibility. Grounded in the International Typographic Style with tactile physical materiality.

01

Architectural Rigor

4px baseline rhythm, strict 12-column geometry, and negative display tracking (-0.02em) ensure density, optical order, and uncompromised hierarchy.

Zero arbitrary pixel offsets
02

Organic Warmth

Sand canvas (#fcf9f5) evoking natural cotton paper paired with burnt terracotta clay and 1px tactile borders. Replaces sterile neon gradients.

Human-first atelier palette
03

Silent Motion

Asymmetric 150ms-250ms ease-out transitions. Exits are 75% faster than entrances. Elastic bounces, flashing springs, and gratuitous motion are banned.

Pre-flight prefers-reduced-motion
Foundational Tokens

Color Palette & The Dark Viewport Contrast Lab

Click any color swatch below to copy its hex value directly to your clipboard.

1. Core Palette Anchors

2. Sand Canvas Elevation Hierarchy (Tonal Stepping)

Critical Contrast Invariant (WCAG 2.2 AA / AAA)

The Dark Viewport Rule: #fe9972 vs #974727

Base Terracotta (#974727) has only a 3.20:1 contrast ratio against dark Charcoal (#181b19), failing WCAG AA (4.5:1 required). We enforce Light Terracotta / Coral (#fe9972), achieving a pristine 9.82:1 AAA rating.

Simulate Viewport:
FAIL: 3.20 : 1 (Under 4.5:1)
#974727 on #181b19
$ git checkout feat/loan-calculator
Notice how this text strains human vision and blends into the dark background.
Status: ❌ PROHIBITED on dark viewports. Fails WCAG AA.
PASS: 9.82 : 1 (AAA Certified)
#fe9972 on #181b19
$ git checkout feat/loan-calculator
Crystal clear optical density, effortless readability, and high legibility.
Status: ✅ MANDATORY for all dark viewport accents & commands.
Foreground TokenBackgroundRatioWCAG AAWCAG AAARule Status
Base Terracotta (#974727)Charcoal3.20 : 1FAILFAIL❌ PROHIBITED
Light Terracotta (Coral) (#fe9972)Charcoal9.82 : 1PASSPASS✅ MANDATORY
Charcoal Ink (#181b19)Sand Canvas14.21 : 1PASSPASS✅ MANDATORY
Base Terracotta (#974727)Sand Canvas4.91 : 1PASSPASS (Large)✅ PERMITTED
Pure White (#ffffff)Charcoal16.48 : 1PASSPASS✅ MANDATORY
Typecraft & Scale

Typography & Optical Rhythm

Paired Grotesk warmth with monospace technical clarity. Headings 24px and larger enforce negative optical tracking (-0.02em) to eliminate loose spacing.

Display (48px / 36px) — SemiBold 600text-4xl sm:text-5xl

Craft as the Feature: Architectural Rigor & Organic Warmth

Headline Large (32px / 24px) — Medium 500text-2xl sm:text-3xl

Craft as the Feature: Architectural Rigor & Organic Warmth

Headline Medium (20px / 18px) — Medium 500text-lg sm:text-xl

Craft as the Feature: Architectural Rigor & Organic Warmth

Body Large (18px) — Regular 400text-base sm:text-lg

Craft as the Feature: Architectural Rigor & Organic Warmth

Body Medium (16px) — Regular 400text-sm sm:text-base

Craft as the Feature: Architectural Rigor & Organic Warmth

Label Medium (14px Mono) — JetBrains Monofont-mono text-sm tracking-wide

Craft as the Feature: Architectural Rigor & Organic Warmth

Label Small (12px Mono) — JetBrains Monofont-mono text-xs tracking-wider

Craft as the Feature: Architectural Rigor & Organic Warmth

Spatial Geometry

4px Baseline Rhythm & Varied Radii Hierarchy

All spatial dimensions lock to multiples of 4px. Border radii scale proportionally so outer containers remain larger than nested controls.

Interactive 4px Baseline Rhythm Step Selector

Current: 16px (p-4 / gap-4)
Dimension: 16px (1.00rem) • Tailwind: p-4 / gap-4

Varied Radii Hierarchy (Concentric Nesting)

rounded-xl1.5rem (24px)
Outer Section / Modal

Main studio viewport enclosures and drawer shells

Sample Box
rounded-lg1.0rem (16px)
Mid Container / Card

Case study preview cards, sub-panels, and dialogs

Sample Box
rounded-md0.75rem (12px)
Inner Interactive Control

Action buttons, form text inputs, select wells

Sample Box
rounded-default0.5rem (8px)
Micro Element / Keycap

Keyboard shortcuts, tags, and small badges

Sample Box
rounded-full9999px
Status Pill / Chip

Phase chips, deliverable status tags, live dots

Sample Box
Interactive Catalog

Interactive Component Playground

Test live component states: tactile click counters, simulated loading triggers, error inputs, status chips, and elevation cards.

Buttons & State Controls

Clicks: 0
Tokens: rounded-md (12px), min touch height 40px, active scale 0.98.

Status Chips & Phase Tags (No // Slop)

Zero Code Delimiters
Stage 1: Intent & Scope
Stage 2: Architecture & Specs
Stage 3: Build & Test
Stage 4: Review & Ship
Passing (9.82:1 AAA)
Invariant: Explicit structured phase tags. NEVER slice strings with role.split(' ')[0].

Form Controls & Accessible Validation

WCAG 2.2 Compliant

Valid recipient. Ready for RFC-compliant transmission.

Error tokens bind to --color-error (#ba1a1a) with accessible assistive text.

Surface Elevation & Tactile Depth

Zero Blurry Shadows
L1 Surface Card
1px Swiss hairline border, flat tonal backdrop.
L2 Ambient Elevation
Pure white fill with gentle hover micro-elevation.
Rule: Depth is produced through tonal stepped fills and 1px hairlines, not heavy black drop shadows.
Signature Centerpiece

The Executive Studio Viewport Pattern

The focal centerpiece of the portfolio. Enforces dark Charcoal (#181b19), top-right Terracotta rim lighting, 16px dot matrix backdrop, Swiss corner ticks, glassmorphism dock header, and #fe9972 AAA contrast accents.

+
+
+
+
~/projects/loan-amortizer (Spec Locked)
# Executive Studio CLI — Deterministic Verification Loop
$npx portfolio-verify --contrast --specs --tests
[WCAG 2.2 AAA] Foreground #fe9972 on #181b19 Charcoal confirmed at 9.82:1.
[Anti-AI-Slop] 0 code delimiters (//) found in user-facing copy.
[Optical Scale] Display headings bound to negative tracking (-0.02em).
[Tests] 9/9 Vitest test suites passing with zero warnings.
$Ready for deployment.
Production Ready
Layout: items-stretch + flex-1 flex-col justify-between
Motion Ergonomics

Silent Motion & Micro-Interactions Lab

Micro-motion exists solely to reinforce user agency and spatial context. Entrances: 150-250ms ease-out. Exits: 100-150ms ease-in (~75% faster).

1. Tactile Modal Dialog (150ms-250ms Ease-Out)

Smooth arrival with background blur, instant crisp exit, and zero spring wobbles.

2. Slide-Over Spec Drawer

Slides smoothly from the right viewport margin for auxiliary inspection without losing main context.

Simulate OS @media (prefers-reduced-motion: reduce)

Instantly clamps transition-duration and animation-duration to 0ms for accessibility compliance.

Voice & Editorial Tone

Editorial Rules & Anti-AI-Slop Rubric

Strictly authoring technical specifications in ASD-STE100 and user-facing copy in CEFR A2 English. Artificial robotic tropes, code delimiters (//), and generic hype words are permanently banned.

Generic AI Slop (Banned)Swiss Precision (Production Standard)Engineering Rationale
01 // INTENT & SCOPEStage 1: Intent & ScopeZero code delimiters (//). Delimiters create robotic visual noise rather than clean human structure.
STAGE 2 // ARCHITECTUREStage 2: Architecture & SpecsEliminates fake sci-fi HUD tropes. Natural Title Case improves optical clarity.
Independent Reviewer Veto PowerStrict Quality Gate: Merges are blocked if any tests failReplaces dystopian AI jargon with plain, direct operational facts.
Leveraging SOTA paradigms to unlock synergyBuilding with verified web standards and deterministic testsStrips generic tech-bro buzzwords. ASD-STE100 mandates clear, verifiable verbs.
Seamless and effortless experienceSingle-screen navigation with sub-cent loan amortization mathReplaces hollow superlatives with concrete domain engineering proof.
Delve into our cutting-edge AI stackInspect our multi-agent orchestrator code and test logs"Delve" is a dead giveaway for generic AI prose. Use active engineering verbs.
role.split(" ")[0] (Dynamic pill clipping)phaseTag: "Architecture" (Explicit structured metadata)Runtime string slicing creates fragile UI states; structured metadata guarantees clean rendering.
Jed Mamosto • Swiss Minimalist Design System Spec v1.0.0