Colophon

How this site is built, and why.

The portfolio is a small product in its own right, built with the same habits as the work it shows: explicit variables, honest trade-offs, and nothing a visitor can't use. The stack on the right is this site's own architecture: tokens, components, an app shell, then the screen you're reading.

Illustration: four layers of a design system (tokens, components, app shell, and a finished screen) stacked in an exploded view. Switching the demo brand re-themes every layer at once. Currently showing Brand A.

One token change Every layer above it re-themes.

Decisions

  1. 01

    Three tiers of tokens, not a utility framework

    tokens/tokens.json (W3C DTCG format) compiles to CSS custom properties: primitives, semantic intent with light and dark modes, then component tokens. References stay as var() chains, so light and dark mode only override the semantic tier, the same way a client brand works on the white-label platform in case study 02.

  2. 02

    GSAP for choreography, Motion for state

    GSAP (ScrollTrigger, SplitText) runs the headline reveals and the scroll-linked layer stack on this page. Motion handles state-driven UI: every exhibit's layout transitions, presence, and springs. Scroll reveals are CSS plus one shared IntersectionObserver, so server components stay server components.

  3. 03

    CSS 3D instead of WebGL

    The exploded layer stack on this page is DOM and CSS 3D. Text stays crisp vector type, color tokens drive it directly, and it ships no 3D engine. Three.js was considered and rejected here: it would rasterize the UI onto textures and add weight for a diagram.

  4. 04

    Static HTML first, islands second

    Every page is pre-rendered at build time. Only the interactive exhibits hydrate, and each page loads only the exhibits it uses. Case studies are fully readable, and crawlable, without JavaScript.

  5. 05

    Accessible by construction

    A script checks every text and UI color pair against WCAG AA in both modes. Reduced-motion visitors get final states with no autoplay; anything that advances on its own pauses on hover, focus, and offscreen, and has a pause control. Exhibits use native inputs, radio groups, and live regions, and every one is keyboard operable.

  6. 06

    Public-safe case studies

    The US health-insurance clients are never named, and every visual of that work is redrawn with demo brands and illustrative data, with no client screens, internal codenames, or file links. Jet Airways and Dubai Municipality are named because that work was public, and the Jet Airways screens are real ones from my own files.

Tokens, live

204 tokens across three tiers. These swatches read the same custom properties the site uses, so switching the theme changes them too.

Tier 1 · primitive · neutral

  • 0
  • 25
  • 50
  • 100
  • 200
  • 300
  • 400
  • 500
  • 600
  • 700
  • 800
  • 850
  • 900
  • 950
  • 1000

Tier 1 · primitive · accent palettes

  • ultramarine
  • turquoise
  • violet
  • vermilion
  • cobalt
  • teal
  • sand
  • ink
  • mist
  • blue
  • tint

Tier 2 · semantic, mode-aware

--surface-canvas
--surface-raised
--surface-sunken
--surface-muted
--surface-highlight
--surface-inverse
--surface-band
--text-primary
--text-secondary
--text-tertiary
--text-inverse
--text-positive
--text-critical
--border-subtle
--border-default
--border-strong
--accent-solid
--accent-strong
--accent-soft
--accent-on-solid
--accent-bright
--accent-on-bright

Tier 3 · component

  • button7 tokens
  • card4 tokens
  • chip3 tokens
  • fork5 tokens
  • rail2 tokens
  • metric2 tokens
  • exhibit3 tokens
  • deck8 tokens

Components never reference primitives directly. Changing a semantic token re-themes every component that consumes it.

Type

Self-hosted, no third-party font requests. Fluid sizes via clamp().

  • Libre Caslon Display · titles and headingsDecisions, not artifacts
  • Atkinson Hyperlegible Next · body, chosen because it keeps similar letters distinct for low-vision readersEvery study opens with a 30-second snapshot and ends with what I would change.
  • Atkinson Hyperlegible Mono · code and tokens--accent-solid: var(--color-violet-500);
  • IBM Plex Sans Arabic · RTL exhibitتجديد رخصة البناء

Stack

  • Next.js App Router
  • React
  • TypeScript
  • CSS Modules
  • W3C design tokens
  • GSAP + ScrollTrigger + SplitText
  • Motion
  • Static generation