<!-- SPDX-License-Identifier: MIT -->
<!-- SPDX-FileCopyrightText: 2025-2026 Marcus Quinn -->

# Design System: Corporate Friendly — Colour Palette

## Primary

| Role | Hex | CSS Variable | Usage |
|------|-----|-------------|-------|
| Primary | `#3b82f6` | `--color-primary` | Primary buttons, active links, selected states |
| Primary Light | `#60a5fa` | `--color-primary-light` | Hover accents, progress indicators |
| Primary Dark | `#2563eb` | `--color-primary-dark` | Active/pressed states |
| Primary Subtle | `#eff6ff` | `--color-primary-subtle` | Tinted backgrounds, info banners, selected rows |

## Accent

| Role | Hex | CSS Variable | Usage |
|------|-----|-------------|-------|
| Accent | `#f97316` | `--color-accent` | Secondary CTAs, highlights, badges, notifications |
| Accent Light | `#fb923c` | `--color-accent-light` | Hover on accent elements |
| Accent Dark | `#ea580c` | `--color-accent-dark` | Active/pressed accent states |
| Accent Subtle | `#fff7ed` | `--color-accent-subtle` | Accent-tinted backgrounds, feature callouts |

## Text

| Role | Hex | CSS Variable | Usage |
|------|-----|-------------|-------|
| Heading | `#111827` | `--color-text` | All headings h1–h6 |
| Body | `#374151` | `--color-text-body` | Paragraph text, descriptions |
| Secondary | `#6b7280` | `--color-text-secondary` | Captions, helper text, metadata |
| Tertiary | `#9ca3af` | `--color-text-tertiary` | Placeholders, disabled text |
| Inverse | `#FFFFFF` | `--color-text-inverse` | Text on dark/coloured backgrounds |

## Surface

| Role | Hex | CSS Variable | Usage |
|------|-----|-------------|-------|
| Background | `#FFFFFF` | `--color-surface` | Primary page background |
| Surface | `#F9FAFB` | `--color-surface-alt` | Alternate sections, sidebar, card backgrounds |
| Surface Warm | `#FFFBF5` | `--color-surface-warm` | Testimonial sections, callout areas |
| Border | `#E5E7EB` | `--color-border` | Default borders, dividers |
| Border Strong | `#D1D5DB` | `--color-border-strong` | Input focus borders, active separators |

## Semantic

| Role | Hex | Background | CSS Variable | Background Variable | Usage |
|------|-----|-----------|-------------|-------------------|-------|
| Success | `#16a34a` | `#f0fdf4` | `--color-success` | `--color-success-bg` | Completion, positive feedback |
| Warning | `#eab308` | `#fefce8` | `--color-warning` | `--color-warning-bg` | Caution, pending review |
| Error | `#ef4444` | `#fef2f2` | `--color-error` | `--color-error-bg` | Validation errors, destructive actions |
| Info | `#3b82f6` | `#eff6ff` | `--color-info` | `--color-info-bg` | Tips, informational messages |
