Skip to content

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 ​

primary#117BE5Marketing CTA · links · highlights
primary.hover#1268C4Button hover state
primary.light#177BE5Gradient start · inline highlight
secondary#b0b21bAccent · badges · secondary actions
TokenHexUsage
primary#117BE5Primary CTA buttons, links, key highlights
primary.hover#1268C4Button hover state
primary.light#177BE5Gradient start, inline highlights
secondary#b0b21bAccent, 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 (#151D28 marketing / #003977 in-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 (#F0F6FF paleBlue, #D2E4F8 lightBlue, #f5f9ff in-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 ​

backgroundWhite#F9FAFBPage background (light sections)
background.card#FBFBFFCard / panel backgrounds
background.lightBlue#D2E4F8Subtle blue tint · gradient end
background.paleBlue#F0F6FFVery light section backgrounds
background.dark#151D28Footer · dark hero sections
TokenHexUsage
backgroundWhite#F9FAFBPage background (light sections)
background.card#FBFBFFCard/panel backgrounds
background.lightBlue#D2E4F8Subtle blue tint, gradient end
background.paleBlue#F0F6FFVery light section backgrounds
background.dark#151D28Footer, dark hero sections (gray-800)
background.overlayrgba(255,255,255,0.08)Card overlays on dark backgrounds

Greyscale scale ​

TokenHexUsage
gray.800#151D28Darkest — footer backgrounds
gray.700#333C48Dark text on light backgrounds
gray.600#526174Secondary text
gray.500#778396Placeholder text
gray.400#8D98A9Borders, dividers
gray.300#CDD3DBSubtle borders
gray.200#D9DEE4Disabled states
gray.100#E6E9EDInput backgrounds
gray.50#F4F5F7Hover backgrounds
gray.25#FAFAFANear-white surfaces

Semantic / status colours ​

success#18AA00Positive · completed
error#E51A17Destructive · errors
warning#E58117Caution states
info#117BE5Informational (= primary)
neutral#E2E3E4Neutral chips · tags
TokenHexUsage
success#18AA00Positive states, completed
error#E51A17Destructive actions, errors
warning#E58117Caution states
info#117BE5Informational (same as primary)
neutral#E2E3E4Neutral 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).

submitted.bg#FDF3E8Awaiting verification — amber tier
submitted.text#8F4C0E7.4:1 on #FDF3E8
verified.bg#E8F7E3Approved — lightest green
verified.text#0F5E088.6:1 on #E8F7E3
rejected.bg#FCEAE9Rejected — pale red
rejected.text#8B0F0D8.4:1 on #FCEAE9
StateHue familyBackgroundTextContrastIcon (MUI)
submittedwarning/amber#FDF3E8#8F4C0E7.4:1HourglassEmptyOutlined
verifiedsuccess/green#E8F7E3#0F5E088.6:1CheckCircleOutlined
rejectederror/red#FCEAE9#8B0F0D8.4:1CancelOutlined

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 ​

baseText#1B1B1BDefault body text on light
link#1B75D0Inline hyperlinks
white#FFFFFFText on dark / navy
TokenHexUsage
baseText#1B1B1BDefault body text on light backgrounds
link#1B75D0Inline hyperlinks
white#FFFFFFText on dark/navy backgrounds

Gradients ​

NameValueUsage
Card highlightlinear-gradient(339.87deg, #FFFFFF 73.24%, #177BE5 200.55%)Hero product cards
Blue washlinear-gradient(to bottom, #fbfbff, #d2e4f8)Section backgrounds
Accent barlinear-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.

primary#117BE5Buttons · links · interactive CTA (matches Moreton Blue designs)
primaryHover#1268C4Button hover state
darkBlue#003977PPP Dark Navy — headings · borders · icon chrome · widget anchor
primaryLight#f5f9ffLight backgrounds
TokenHexUsage
primary#117BE5Buttons, links, interactive CTA — matches MB designs
primaryHover#1268C4Button hover / pressed state
darkBlue#003977Headings, borders, icon chrome, widget brand anchor
primaryLight#f5f9ffLight blue tint backgrounds
primaryAlpha4rgba(0, 57, 119, 0.04)Subtle hover background

Rule: All contained Button components use primary (#117BE5) via the MUI theme — never hardcode #117BE5 in 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.

Surgical#0D6B9EMain · light #E6F3FA · 5.2:1
WBA#167D62Main · light #E8F7F3 · 4.5:1
Retrospective#6B4C9AMain · light #F3EFF8 · 5.8:1
Timesheets#B35E18Main · light #FDF3E8 · 4.8:1
CPD#003977Main · light #F5F9FF · 9.5:1
CategoryMainLightLineDarkContrast
Surgical#0D6B9E#E6F3FA#BFE0F0#084A6E5.2:1
WBA#167D62#E8F7F3#BFE3D5#0F5E4B4.5:1
Retrospective#6B4C9A#F3EFF8#D6C9E5#47327A5.8:1
Timesheets#B35E18#FDF3E8#F0D4B8#8F4C0E4.8:1
CPD#003977#F5F9FF#CCDCEB#0022449.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.

typescript
import COLORS from 'themes/colors';

// Use tokens, not raw hex in components
bgcolor: COLORS.ppp.primary; // ✅
bgcolor: '#117be5'; // ❌ (except in the theme file itself)

Internal documentation — org members only