Colours
Semantic colour tokens defined in src/index.css. Never hardcode hex values — always consume the mapped Tailwind class (e.g. bg-primary).
Typography
Full type scale, mapped in tailwind.config.js. Body copy uses a slightly darker foreground token for improved readability contrast.
text-displaytext-h1text-h2text-h3text-h4text-body-lgtext-bodytext-smalltext-captionSpacing
8px grid system. Tailwind's default spacing scale already maps 1-to-1 to our grid — always use these scale numbers (p-4, gap-6, etc.), never arbitrary pixel values.
p-14pxp-28pxp-416pxp-624pxp-832pxp-1248pxp-1664pxp-2496pxShadows & Radius
Elevation and corner-rounding tokens, kept subtle to preserve the calm, premium aesthetic.
Motion
Minimal, consistent motion. Button/card hovers use duration-base (200ms), fade-ins use 250-350ms, modals/drawers use 250ms — all with the standard ease-out curve.
- Fade-in sections: 250–350ms, ease-out, translate-y-2 → 0
- Modals: 250ms scale + fade
- Drawers: 250ms slide + fade
- No bounce, no large movement — motion should feel calm
Cards, Badges & Alerts
Standard containers for grouping content and surfacing status.
Card title
Cards use bg-card, rounded-lg and shadow-soft by default.
Heads up
Quality Gate
Every component passes through this checklist before it is considered complete and merged.
Component Acceptance Checklist
- Uses design tokens only — no hardcoded colours, spacing or typography
- Mobile responsive across all breakpoints
- Keyboard accessible with visible focus states
- Screen-reader compatible (semantic HTML, labels, alt text)
- Reusable — not a one-off, single-page component
- Documented in this Brand System page
- Performance tested (no layout shift, lightweight)
- Supports future extension without modification
Performance Checklist
- Mobile-first responsive
- Accessible — WCAG 2.1 AA compliant
- Dark mode compatible
- Lighthouse target: Performance 95+, Accessibility/Best Practices/SEO 100
- SEO friendly, semantic HTML
- Optimised for Core Web Vitals