Design System

A living reference for the tokens, typography, motion, and components that this portfolio is built from. Everything below is rendered with the same primitives used across every page.

Foundations

Design tokens live as CSS custom properties on :root. A media query seeds them from prefers-color-scheme; an html.light or html.dark class from the theme toggle takes precedence. Tailwind v4’s @theme inline block exposes each variable as a utility (text-fg, bg-bg, border-border).

Three axes: semantic tokens (not hex values) drive every surface, a restrained 8-step spacing grid drives every layout, and five keyframes drive every movement. If something needs a new value, the first question is whether an existing token already covers the intent.

Color

One token set, resolved through light-dark(). Surfaces step from page to surface to hover, text steps from ink to ink-2 to ink-3, and the accent is the ink itself: no colour accent anywhere.

TokenLightDarkUsage
--pageoklch(98.5% 0.001 286)oklch(20.9% 0.004 264)Page background
--surfaceoklch(100% 0 0)oklch(26% 0.006 271)Cards, panels, the stage under screenshots
--inkoklch(24.7% 0.006 258)oklch(96.4% 0.002 248)Primary text, headings, links, the accent
--ink-2oklch(50.6% 0.01 264)oklch(73.1% 0.008 261)Secondary text, summaries
--ink-3oklch(69.5% 0.009 265)oklch(54.1% 0.01 264)Labels, dates, meta
--lineoklch(94.6% 0.003 265)oklch(30.8% 0.006 258)Card rings and stronger rules
--line-softoklch(96.6% 0.002 265)oklch(27.8% 0.006 258)Hairline dividers between rows

Edges come from shadows, not borders: shadow-card is a 1px ring of line inside a soft shadow, shadow-raised lifts it on hover. Rows divide with line-soft. Radii are fixed: chip 6, control 8, card 10, window 14.

Typography

One typeface: Inter Tight, loaded via Google Fonts, with Google Sans Code for labels and meta. Headings sit at 400 with tight tracking; 500 and 600 are for emphasis inside a line, never for headings.

h1Page statement3.75rem / 400
h2Section heading24px / 400
h3Row or card title20px / 400
pBody prose inside articles and case studies.16px / 400
smRow summaries, captions, small metadata.15px / 400
xsMono section labels, dates, tags11px / 400

Spacing

A 4-pixel grid. Every margin, padding, and gap snaps to these steps. Tailwind’s default scale matches closely; the site only reaches for arbitrary values when the grid genuinely doesn’t fit.

4px
8px
12px
16px
20px
24px
32px
40px
48px
64px
80px

Motion

Five keyframes for the whole site. Long-running decorative animations were removed. What remains is functional: entrance, response confirmation, and live-signal pulses.

KeyframeDurationUse
fade-up400msPage and section entrance
fade-in250msSimple opacity reveals
chat-msg-in400msMessage bubbles, CodeLens panel transitions
chat-typing-dot1.2sTyping indicators, live-status pulses

All timings ease with cubic-bezier(0.16, 1, 0.3, 1). Reduced-motion preferences turn entrance animations off; live-signal pulses remain because they’re informational, not decorative.

Hello.fade-up
chat-typing-dot

Components

Components here are the primitives that actually ship across the site, rendered with mock data so you can see the exact states.

Section heading

H2 inside a case study or article

When the data is actually live

Primary link

Underlined fg with muted decoration that deepens on hover

Secondary link

Muted text that brightens to fg on hover

Pill tab

Tab row for chart timeframes, code-review findings, filter modes

Context tag

Inline category marker on work rows

ClientPersonalCompanyStartup

Icons

Hand-rolled SVG, 14×14 viewBox, currentColor, 1.2–1.5 stroke width. No icon library; each icon is a single path or small group inlined where it’s used.

Back
Arrow right
External
Close
Check
Copy
Expand
Chevron
Menu
Sun
Moon
Info

Accessibility

WCAG 2.1 AA is the floor, AAA is the target. The site is keyboard-navigable, respects prefers-reduced-motion, and avoids colour as the only channel for meaning.

Contrast

PairDarkLightLevel
ink on page16.0:115.5:1AAA
ink-2 on page7.5:15.6:1AA
ink-3 on page3.5:12.6:1large text only
line on pagen/an/adecorative

Principles

  • Never rely on colour alone. Every chart series ships with a line style and marker shape so it reads without colour.
  • Respect motion preference. All entrance animations are disabled under reduced-motion; informational pulses stay.
  • Keyboard first. Every interactive element is reachable and visibly focused.
  • Contrast above AA. Primary text runs above 17:1 in dark and 19:1 in light.