CPD Colour Palette
The approved colour palette for CPD category charts, badges, and progress indicators across PPP. Every colour on this page has been reviewed for WCAG AA contrast compliance and matches the tokens defined in packages/core-ui/ and packages-shared/ppp/src/constants/.
For the brand story, logo usage, and general colour system beyond CPD categories, see Brand → Colour.
Approved palette — Option C
#167D62 · Light bg #E6F4EF · Text / dark #0F5A46#B35E18 · Light bg #FDF0E4 · Text / dark #7C4211#0D6B9E · Light bg #E4F0F7 · Text / dark #094D72#003977 · Light bg #F5F9FF · Text / dark #002244Palette reference table
| Category | Primary | Light bg | Text / Dark | Border |
|---|---|---|---|---|
| Education Activities (EA) | #167D62 Forest Green | #E6F4EF | #0F5A46 | #167D62 |
| Measuring Outcomes (MO) | #B35E18 Burnt Orange | #FDF0E4 | #7C4211 | #B35E18 |
| Reviewing Performance (RP) | #0D6B9E Ocean Blue | #E4F0F7 | #094D72 | #0D6B9E |
| Combined (MO + RP) | #003977 Deep Navy | #F5F9FF | #002244 | #003977 |
Doughnut chart usage rules
- Use the light colour for the segment fill.
- Use the primary colour for the stroke / border.
- Do not use saturated MUI defaults — they fail WCAG contrast against white backgrounds at small sizes.
- Cultural Safety is a program-level requirement, not a standalone chart segment. It must not appear as its own doughnut slice. If you need to show Cultural Safety compliance, render it as a separate badge or callout alongside the chart, never inside it.
Correct vs wrong — visual
✅ Correct — light fill + primary rim
Airy. Category readable. Matches Matt's 2024 Moreton Blue design. WCAG AA on text + border combo.
❌ Wrong — saturated fills
Dominant. Heavy. Loses the clinical-calm tone. Matt called this out 22 Apr — every dev pass re-introduces it unless the rule is followed.
Drift-prevention checklist
- [ ] Chart fill uses
*.lighthex (not*.primary) - [ ] Stroke / border uses
*.primaryhex - [ ] Legend chips use light background + primary border
- [ ] No hardcoded
#117BE5(marketing blue) inside CPD category charts — PPP in-app primary is#003977 - [ ] Icons for categories are tinted light, not solid
Accessibility (WCAG AA compliance)
All four primaries meet WCAG AA (≥ 4.5:1) contrast against white. The Combined colour meets AAA.
| Colour | Hex | Contrast on white | Grade |
|---|---|---|---|
| EA — Forest Green | #167D62 | 4.5:1 | ✅ AA |
| MO — Burnt Orange | #B35E18 | 4.8:1 | ✅ AA |
| RP — Ocean Blue | #0D6B9E | 5.2:1 | ✅ AA |
| Combined — Deep Navy | #003977 | 9.5:1 | ✅ AAA |
The light-background variants (#E6F4EF, #FDF0E4, #E4F0F7, #F5F9FF) are intended to sit behind the text/dark colour. Pair every light-bg hex with its matching text/dark hex from the reference table — never mix-and-match primary on light-bg; the contrast will fail.
Rejected options
Two alternative palettes were evaluated before landing on Option C. They're preserved here as a decision audit trail.
| Option | EA | MO | RP | Why rejected |
|---|---|---|---|---|
| A — MUI default palette | #2E7D32 | #ED6C02 | #0288D1 | Saturated hues — multiple primaries fell below 4.5:1 on white, particularly #ED6C02. Failed WCAG AA. |
| B — High-saturation traffic-light | #22C55E | #F97316 | #3B82F6 | Cultural-safety connotation mismatch with "traffic-light green = safe". Also failed the brand review — too aggressive for a clinical-facing UI. |
| C — Muted earth tones (approved) | #167D62 | #B35E18 | #0D6B9E | All four primaries pass WCAG AA. Calmer hues fit the clinical tone. Combined navy provides a clear semantic for MO+RP aggregation. |
Implementation pointers
- Frontend tokens: see
packages/core-ui/theme +instances/ppp/src/theme/for the MUI palette wiring. - Shared constants: see
packages-shared/ppp/src/constants/for the canonical hex values that chart components import. - Chart components:
instances/ppp/src/components/charts/— the CPD category doughnut should consume the shared constants, never hardcode hex values.
Related
- Brand → Colour — full brand colour system including neutrals and status colours
- #4523 — original implementation ticket for CPD progress colours (depends on this reference page)
- #3326 — original design decision that landed Option C