Design SystemDesign Tokens

Design Tokens

Design tokens are the atomic building blocks of the Septimius design system, distributed via the @septimius-technology-group/tokens package.

Colour System

Colours use HSL values exposed as CSS custom properties. Each product overrides the primary and accent tokens while inheriting neutral, semantic, and surface scales from the shared foundation.

Typography

Headings use Manrope, body text uses Inter, both with system-ui fallback.

LevelSizeWeight
Display2rem700
H11.5rem700
H21.25rem600
H31.125rem600
Body1rem400
Small0.875rem400
Caption0.75rem400
Overline0.6875rem600

Spacing and Radius

Spacing uses a 4px base unit: spacing-1 (4px), spacing-2 (8px), spacing-3 (12px), spacing-4 (16px), spacing-6 (24px), spacing-8 (32px).

Border radius tokens: sm (6px), md (8px), lg (12px), xl (16px), 2xl (20px).

Shadows

Four elevation levels: shadow-sm (cards, inputs), shadow-md (dropdowns, popovers), shadow-lg (modals, dialogs), and shadow-glow (cyan-tinted focus).

Motion

TokenDurationUse Case
duration-instant0msImmediate state changes
duration-fast100msMicro-interactions, toggles
duration-normal200msStandard transitions
duration-slow300msPanel slides, expansions
duration-slower500msPage-level transitions

Easing curves include ease-default for general transitions and ease-spring for physics-based motion on interactive elements.