name: design-language-system
description: Maintains visual consistency across portfolio UI components. Use when creating or modifying components, styling pages, or ensuring design consistency. Includes coral colour tokens (OKLCH), typography scale, spacing rules, animations, and component patterns.
Design Language System
Use this guide when creating or modifying UI components to ensure visual consistency across the portfolio.
Colour Tokens
Base Palette
Token
OKLCH
Hex
Usage
--background
oklch(0.985 0.005 90)
#FAF9F7
Page background (warm paper white)
--foreground
oklch(0.15 0.01 270)
#1F1F23
Primary text (deep charcoal)
--card
oklch(1 0 0)
#FFFFFF
Card backgrounds
--card-foreground
oklch(0.15 0.01 270)
#1F1F23
Card text
--muted
oklch(0.96 0.005 90)
#F3F2F0
Muted backgrounds
--muted-foreground
oklch(0.45 0.01 270)
#6B6B73
Secondary text
--border
oklch(0.90 0.005 90)
#E5E4E2
Borders
Coral Accent (Primary)
Token
OKLCH
Hex
Usage
--primary
oklch(0.60 0.18 25)
#E07356
Primary buttons, links, accents
--primary-foreground
oklch(0.98 0.01 25)
#FDF8F7
Text on primary
--ring
oklch(0.70 0.15 25)
#EBA08A
Focus rings, hover glows
Typography
Fonts
Sans (Body): Figtree via --font-sans
Mono (Code): Geist Mono via --font-mono
Scale
Variant
Class
Usage
h1
text-5xl font-bold tracking-tight
Page titles
h2
text-3xl font-semibold tracking-tight
Section headings
h3
text-xl font-semibold
Card titles
body-lg
text-lg leading-relaxed
Introductions, emphasis
body
text-base
Default body text
body-sm
text-sm
Secondary content
caption
text-sm text-muted-foreground
Metadata, dates
label
text-xs font-medium uppercase tracking-wider
Labels, categories
Heading Styles
Letter-spacing: -0.03em on h1, h2
Use tracking-tight class
Colour: text-foreground
Spacing
Rules
Use gap-* utilities for spacing between elements
Avoid margin-top, prefer margin-bottom or gap
Use even numbers only: gap-2, gap-4, gap-6, gap-8, gap-12
Use gap-* instead of gap-x-*/gap-y-* (cleaner, same behaviour in flex containers)