Colour
The PPP colour system is built around brand blue #117BE5 for marketing surfaces and PPP dark blue #003977 for in-app workspaces, supported by a ten-step greyscale, a small set of semantic state colours, and a background palette tuned for medical-professional contexts.
Primary brand colours
| Token | Hex | Usage |
|---|---|---|
primary | #117BE5 | Primary CTA buttons, links, key highlights |
primary.hover | #1268C4 | Button hover state |
primary.light | #177BE5 | Gradient start, inline highlights |
secondary | #b0b21b | Accent, badges, secondary actions |
Colour application rules
Our colour system is deliberately tight — restraint is what makes the brand feel premium and clinical rather than corporate. As a proportion of any layout:
- ~60% white or pale grey (
#F9FAFB,#F4F5F7) — this is what makes our pages feel clinical and uncluttered. - ~30% dark navy (
#151D28marketing /#003977in-app) — headers, footers, feature panels, and large quoted statistics on dark surfaces. - ~10% brand blue (
#117BE5) — reserved for calls-to-action, key statistics, icons, and active links. Its scarcity is what makes it work.
Further rules:
- Never place brand blue directly on navy as a large block of body text — the contrast is insufficient. Use white text on navy, and reserve blue for accents and standalone elements.
- The blue tint backgrounds (
#F0F6FFpaleBlue,#D2E4F8lightBlue,#f5f9ffin-app) are the only acceptable blue tints for card and section fills — don't introduce additional blue tints. - Functional colours (success / warning / error, below) carry specific meaning inside the product — avoid using them in marketing materials.
Background colours
| Token | Hex | Usage |
|---|---|---|
backgroundWhite | #F9FAFB | Page background (light sections) |
background.card | #FBFBFF | Card/panel backgrounds |
background.lightBlue | #D2E4F8 | Subtle blue tint, gradient end |
background.paleBlue | #F0F6FF | Very light section backgrounds |
background.dark | #151D28 | Footer, dark hero sections (gray-800) |
background.overlay | rgba(255,255,255,0.08) | Card overlays on dark backgrounds |
Greyscale scale
| Token | Hex | Usage |
|---|---|---|
gray.800 | #151D28 | Darkest — footer backgrounds |
gray.700 | #333C48 | Dark text on light backgrounds |
gray.600 | #526174 | Secondary text |
gray.500 | #778396 | Placeholder text |
gray.400 | #8D98A9 | Borders, dividers |
gray.300 | #CDD3DB | Subtle borders |
gray.200 | #D9DEE4 | Disabled states |
gray.100 | #E6E9ED | Input backgrounds |
gray.50 | #F4F5F7 | Hover backgrounds |
gray.25 | #FAFAFA | Near-white surfaces |
Semantic / status colours
| Token | Hex | Usage |
|---|---|---|
success | #18AA00 | Positive states, completed |
error | #E51A17 | Destructive actions, errors |
warning | #E58117 | Caution states |
info | #117BE5 | Informational (same as primary) |
neutral | #E2E3E4 | Neutral chips/tags |
Status states (workflow chips)
Workflow chips for CPD activities, approvals, and review queues use a 3-state palette tuned for WCAG 2.1 AA contrast (≥ 4.5:1 normal text). Each state pairs a unique hue with an icon in the consuming component so the states stay distinguishable for colour-blind users (#4844).
| State | Hue family | Background | Text | Contrast | Icon (MUI) |
|---|---|---|---|---|---|
submitted | warning/amber | #FDF3E8 | #8F4C0E | 7.4:1 | HourglassEmptyOutlined |
verified | success/green | #E8F7E3 | #0F5E08 | 8.6:1 | CheckCircleOutlined |
rejected | error/red | #FCEAE9 | #8B0F0D | 8.4:1 | CancelOutlined |
The tokens live on SEMANTIC_COLORS.status in instances/ppp/src/themes/tokens.ts. Never hard-code these hexes in components — always import the token.
CPD wheel colours
CPD category colours and verified-pastel variants are maintained in one place: CPD Colour Palette. Reference that page — do not duplicate the palette table here.
Text colours
| Token | Hex | Usage |
|---|---|---|
baseText | #1B1B1B | Default body text on light backgrounds |
link | #1B75D0 | Inline hyperlinks |
white | #FFFFFF | Text on dark/navy backgrounds |
Gradients
| Name | Value | Usage |
|---|---|---|
| Card highlight | linear-gradient(339.87deg, #FFFFFF 73.24%, #177BE5 200.55%) | Hero product cards |
| Blue wash | linear-gradient(to bottom, #fbfbff, #d2e4f8) | Section backgrounds |
| Accent bar | linear-gradient(to left, #177BE5, white) | Decorative rule/dividers |
PPP brand foundation (in-app)
The in-app workspace uses a two-blue system — the interactive/button primary is the lighter brand blue; the PPP dark navy is reserved for headings, borders, and icon chrome. Tokens live in instances/ppp/src/themes/colors.ts.
| Token | Hex | Usage |
|---|---|---|
primary | #117BE5 | Buttons, links, interactive CTA — matches MB designs |
primaryHover | #1268C4 | Button hover / pressed state |
darkBlue | #003977 | Headings, borders, icon chrome, widget brand anchor |
primaryLight | #f5f9ff | Light blue tint backgrounds |
primaryAlpha4 | rgba(0, 57, 119, 0.04) | Subtle hover background |
Rule: All contained
Buttoncomponents useprimary(#117BE5) via the MUI theme — never hardcode#117BE5in a component.darkBlue(#003977) is for typographic and structural chrome only.
Dashboard widget colour palette
Each dashboard widget category has a distinct hue. All "main" colours meet WCAG 2.1 AA contrast (4.5:1) against white. The full palette is centralised in instances/ppp/src/components/widgets/constants/widgetConstants.ts.
| Category | Main | Light | Line | Dark | Contrast |
|---|---|---|---|---|---|
| Surgical | #0D6B9E | #E6F3FA | #BFE0F0 | #084A6E | 5.2:1 |
| WBA | #167D62 | #E8F7F3 | #BFE3D5 | #0F5E4B | 4.5:1 |
| Retrospective | #6B4C9A | #F3EFF8 | #D6C9E5 | #47327A | 5.8:1 |
| Timesheets | #B35E18 | #FDF3E8 | #F0D4B8 | #8F4C0E | 4.8:1 |
| CPD | #003977 | #F5F9FF | #CCDCEB | #002244 | 9.5:1 |
Appraisals shares the Retrospective palette (Main #6B4C9A, Light #F3EFF8) — both are reflective work surfaces, so they read coherently as one category.
Line is the dashed/subtle border tone for outline buttons and minor section separators (~70% interpolation from Main toward Light).
Application rule (carried from CPD palette)
- Chart segment fills use the light hex
- Primary hex is used only as the stroke/border/rim
- Never use saturated primaries as dominant fills — loses the light, airy clinical feel and risks breaking WCAG contrast at small sizes
See Components → Data visualisation patterns for full category colour rules, doughnut chart conventions, and the verified-vs-imported data trust level pattern.
Source of truth
- Marketing colours:
instances/marketing/src/themes/colors.ts - In-app brand foundation:
instances/ppp/src/themes/ - Widget colours:
instances/ppp/src/components/widgets/constants/widgetConstants.ts
Always reference tokens in code, not raw hex values.
import COLORS from 'themes/colors';
// Use tokens, not raw hex in components
bgcolor: COLORS.ppp.primary; // ✅
bgcolor: '#117be5'; // ❌ (except in the theme file itself)