Skip to content

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

Aa

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.

Aa

success

Success, Confirmation

Aa

info

Notice, Information

Aa

warning

Warning, Caution

Aa

danger

Error, Destructive

Aa

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.

TokenSwatch
--background
--foreground
--muted
--muted-foreground
--primary
--border
--border-strong
--accent
Semantic Status Colors
--success
--info
--warning
--danger
--neutral

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

.container

Section Spacing

ViewportPadding (vertical)
Mobile4rem (64px)
Tablet (md)6rem (96px)
Desktop (lg)8rem (128px)

Spacing Scale

1
0.25rem (4px)
2
0.5rem (8px)
3
0.75rem (12px)
4
1rem (16px)
6
1.5rem (24px)
8
2rem (32px)
12
3rem (48px)
16
4rem (64px)
24
6rem (96px)
32
8rem (128px)

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

TokenValue
--ease-glidecubic-bezier(0.12, 0.23, 0.5, 1)
--ease-smoothcubic-bezier(0.16, 1, 0.3, 1)
--ease-springcubic-bezier(0.34, 1.56, 0.64, 1)

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-visible for keyboard navigation
  • 2px ring with offset on all interactive elements
  • Never outline: none without 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

NameWidth
Default< 640px
sm≥ 640px
md≥ 768px
lg≥ 1024px
xl≥ 1280px

Responsive Typography

Display sizes scale by viewport. Heading and body sizes remain stable.

TokenMobileDesktop
display-xl2.5rem (40px)5rem (80px)
display-lg2rem (32px)3.75rem (60px)
display-md1.75rem (28px)2.5rem (40px)

Grid

Mobile

1 column

Tablet (md)

Col 1
Col 2

Desktop (lg)

1
2
3

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% and aspect-ratio
  • Prefer WebP format, JPEG as fallback
  • loading="lazy" for below-the-fold images
  • Explicit width/height to prevent layout shift
Example imagery: person focused at work — authentic, bold, natural light

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
  • currentColor for color adaptation
  • aria-hidden="true" for decorative icons
  • Alt text for informative icons
lightning
layers
shield
chart
code
globe
palette
sparkle

24×24 · stroke-width: 1.5 · currentColor