Globals
The rules of the system.
Principles, tokens, and guidelines that apply everywhere — from colors and typography to accessibility and responsiveness.
01
Principles
Eight guidelines that drive every design decision in the system.
01
Monochrome is enough
Black, white, and gray scales carry the entire design. Contrast, weight, and space create hierarchy.
02
Images break the silence
In a monochrome system, images are the living element. Bold, emotional, and space-filling.
03
Fine lines instead of heavy effects
No decorative gradients, no thick borders. Fine 1px lines as dividers, section separators, and icon stroke weight. Shadows appear only as soft elevation: under images and under layers that float above the page.
04
Whitespace is the primary design tool
Generous spacing is the primary tool for hierarchy and rhythm. Favor more space over less.
05
Typography leads the hierarchy
Geist Sans as the sole typeface. Large headlines, tight leading, deliberate weight shifts from 100–900.
06
Rich interaction as contrast
The exterior is minimalist — but the interaction is alive. Hover effects, scroll reveals, and micro-interactions.
07
Mobile-First, Performance-First
Responsive design is the starting point. Lighthouse 90+ in all categories. Semantic HTML, Open Graph.
08
Usability over aesthetics
WCAG 2.1 AA. Contrast ratios verified. Focus states. Touch targets ≥ 44px. Skip links and ARIA.
02
Colors
Strictly monochrome: neutral grays and one accent. Switch between Light and Dark Mode with the toggle in the top right.
background
foreground
muted
primary
border
Accent Color
accent
accent-foreground
Use sparingly — for CTAs, badges, and special highlights. The only hue in the monochrome system.
Semantic Status Colors
Functional colors for system feedback. No branding — universal UX conventions. Use only in small, context-specific UI elements: toasts, alerts, badges, validation, status dots.
success
Success, Confirmation
info
Notice, Information
warning
Warning, Caution
danger
Error, Destructive
neutral
Default, Inactive
Soft Variants (10% Opacity)
For subtle backgrounds in alert boxes and info fields. Status color as background at low opacity, border at medium opacity, text in the -text token of the status, which stays readable on the tint in both modes.
Saved
Changes applied successfully.
Notice
This feature is in beta.
Caution
Your storage is almost full.
Error
Connection could not be established.
Inactive
This feature is disabled.
| Token | Swatch | Usage |
|---|---|---|
| --background | Page background | |
| --foreground | Primary text | |
| --muted | Secondary surfaces, cards | |
| --muted-foreground | Secondary text, captions | |
| --primary | Buttons, active elements | |
| --border | Fine lines, dividers | |
| --border-strong | Hover borders, active lines | |
| --accent | CTAs, highlights | |
| Semantic Status Colors | ||
| --success | Success, confirmation | |
| --info | Notice, information | |
| --warning | Warning, caution | |
| --danger | Error, destructive | |
| --neutral | Default, inactive | |
03
Typography
Geist Sans + Geist Mono by Vercel. Variable Fonts with weights from 100–900. The token scale for all text sizes.
display-xl · 5rem · 700
Large Headlines
display-lg · 3.75rem · 700
Section Title
display-md · 2.5rem · 600
Subsection Heading
heading-lg · 1.75rem · 600
Card Title or H3
heading-md · 1.25rem · 600
Sidebar Title or H4
heading-sm · 1rem · 600
Label or H5
body-lg · 1.125rem
Lead text for intros and key paragraphs. Geist Sans at 18px with 160% leading.
body-md · 1rem
Standard body text. The base size for all running text in the system.
body-sm · 0.875rem
Captions and meta information. Secondary text for timestamps, authors, and tags.
body-xs · 0.75rem
Badges, footnotes, and the smallest text elements in the system.
Weights
Aa
100 Thin
Aa
300 Light
Aa
400 Regular
Aa
500 Medium
Aa
600 Semibold
Aa
700 Bold
Aa
900 Black
01
Mono 400
04
Spacing & Layout
Container, spacing, and grid rules. Whitespace as the primary design tool.
Container
max-width: 1200px
padding: 1rem → 2rem
Section Spacing
| Viewport | Padding (vertical) | Tailwind |
|---|---|---|
| Mobile | 4rem (64px) | py-16 |
| Tablet (md) | 6rem (96px) | md:py-24 |
| Desktop (lg) | 8rem (128px) | lg:py-32 |
Spacing Scale
05
Interaction
Timing tokens, easing curves, and scroll reveals. Animations bring the minimalist system to life.
150ms ease-out
Hover
Buttons, links, and menus respond quickly and gently.
560ms ease-glide
Reveal
Elements fade in on scroll over 10px. The hero enters in 800ms.
100ms ease-out
Micro
Press feedback on buttons. Fast and precise.
Easing Curves
| Token | Value | Usage |
|---|---|---|
| --ease-glide | cubic-bezier(0.12, 0.23, 0.5, 1) | Hero entrance, scroll reveals |
| --ease-smooth | cubic-bezier(0.16, 1, 0.3, 1) | Large surfaces, image zoom |
| --ease-spring | cubic-bezier(0.34, 1.56, 0.64, 1) | A playful overshoot. Available, not used by a shipped component |
06
Accessibility
WCAG 2.1 AA as the minimum standard. Accessibility is not a feature — it is a prerequisite.
Contrast
- Normal text: at least 4.5:1
- Large text (≥ 18px bold): at least 3:1
- UI elements and icons: at least 3:1
- Be cautious with gray tones on light backgrounds
Focus States
:focus-visiblefor keyboard navigation- 2px ring with offset on all interactive elements
- Never
outline: nonewithout an alternative - Tab order follows the visual order
Touch Targets
- Minimum size: 44 × 44px
- Spacing between targets: at least 8px
- Hover states as enhancement only
- No hover-only content on touch devices
Semantics & ARIA
- Use semantic HTML elements (nav, main, article…)
- Skip link as the first focusable element
- Alt text for all informative images
- ARIA labels for icon-only buttons
prefers-reduced-motion
All animations respect prefers-reduced-motion: reduce. When the setting is active, the page shows its final state from the first paint: no entrance, no scroll reveal, no parallax.
07
Responsiveness
Mobile-First. Every component is designed for the smallest viewport first, then expanded upward.
Breakpoints
| Name | Width | Usage |
|---|---|---|
| Default | < 640px | Mobile (base) |
| sm | ≥ 640px | Large smartphones |
| md | ≥ 768px | Tablets |
| lg | ≥ 1024px | Laptops, desktop |
| xl | ≥ 1280px | Large screens |
Responsive Typography
Display sizes scale by viewport. Heading and body sizes remain stable.
| Token | Mobile | Desktop |
|---|---|---|
| display-xl | 2.5rem (40px) | 5rem (80px) |
| display-lg | 2rem (32px) | 3.75rem (60px) |
| display-md | 1.75rem (28px) | 2.5rem (40px) |
Grid
Mobile
Tablet (md)
Desktop (lg)
08
Imagery & Icons
Guidelines for photography, illustrations, and icon usage in the system.
Photography
- High-quality, authentic images
- Bold, emotional, and space-filling — the living contrast to the monochrome system
- Responsive with
width: 100%andaspect-ratio - Prefer WebP format, JPEG as fallback
loading="lazy"for below-the-fold images- Explicit
width/heightto prevent layout shift

Example: Authentic, bold, natural light
Example Prompt for AI Image Generation
This structured prompt was used to create the example image above. Copy and adapt it to generate images in the same visual style using a suitable AI model (e.g. GPT-4o, Midjourney, Flux).
{
"_meta": {
"image_id": "10_duo_closeup_focused",
"description": "Close-up of two focused colleagues looking together at a screen"
},
"subject": {
"description": "Extreme close-up of two young colleagues intensely looking in the same direction at a screen. The man in the foreground is seen in profile, the woman slightly behind him and out of focus. The mood is intensely focused — a moment of deep collaboration.",
"persons": [
{
"role": "Man (foreground, left, main subject)",
"age": "Mid to late 20s",
"expression": "Focused, serious, intensely concentrated, slightly tense, lips slightly parted",
"hair": {
"color": "Dark brown / black",
"style": "Curly, voluminous natural curls, medium length on top, short on sides"
},
"clothing": {
"top": {
"type": "T-shirt",
"color": "Black",
"details": "Plain, crew neck, relaxed fit"
}
},
"face": {
"preserve_original": false,
"makeup": "None"
},
"pose": "Side profile facing right, right arm raised and pointing forward (gesturing at screen), left hand on own shoulder/neck"
},
{
"role": "Woman (background, right)",
"age": "Mid to late 20s",
"expression": "Focused, thoughtful, attentive, slightly serious",
"hair": {
"color": "Dark brown / black",
"style": "Long, straight, loose, falling over shoulders, center part"
},
"clothing": {
"top": {
"type": "Top",
"color": "Black / dark",
"details": "Only partially visible"
}
},
"face": {
"preserve_original": false,
"makeup": "Subtle, natural"
},
"pose": "Sitting slightly behind the man, looking in the same direction, face partially obscured by the man"
}
]
},
"accessories": {
"props": [
"Screen / monitor (not visible, but implied by gaze direction and gesture; bright light from the right reflected on the arm)"
]
},
"photography": {
"camera_style": "Professional camera, very shallow depth of field (f/1.4-1.8), cinematic",
"angle": "Eye level, side view, profile shot",
"shot_type": "Extreme close-up / tight portrait, face and shoulder area",
"aspect_ratio": "16:9 (widescreen)",
"texture": "Very shallow depth of field, sharp focus only on the man's face, woman in background soft/out of focus, natural skin texture visible, pores and details perceptible"
},
"background": {
"setting": "Modern office / workspace",
"wall_color": "White / light, heavily blurred",
"elements": [
"Window or bright wall in the background (overexposed, blown out)",
"Minimal visible environment due to extreme depth of field"
],
"atmosphere": "Intense, focused, intimate, professional",
"lighting": "Soft, natural side light from the right (window), gentle shadows on the left side of the face, screen light reflected on the forearm, warm skin tones"
},
"style_modifiers": {
"artistic_style": "Cinematic close-up / documentary corporate photography",
"color_grading": "Neutral to slightly warm, muted, natural skin tones, low contrast in midtones, bright background",
"mood": "Intensely focused, collaborative, moment of concentration, tech startup atmosphere"
}
}Icons
- Fine-line SVG icons (stroke-width: 1.5)
- Consistent sizes: 16px, 20px, 24px
currentColorfor color adaptationaria-hidden="true"for decorative icons- Alt text for informative icons
24×24 · stroke-width: 1.5 · currentColor