INBOX/adhd-friendly-colour-variants/calm-blue/calm-blue-style-guide.md
2026-08-07 15:50:54 +02:00

6.4 KiB
Raw Blame History

Calm Denim Blue UI Style Guide

A trustworthy denim-blue system for dashboards, administration and focused work.

This system keeps the interface ADHD-friendly by using calm surfaces, one clear primary colour, one quieter secondary colour and restrained supporting accents.


1. Core principles

  • Use neutral surfaces for most of the page.
  • Reserve the primary colour for the next important action.
  • Use the secondary colour for optional or supporting actions.
  • Use spacing and typography before adding more colour.
  • Present one main task at a time.
  • Avoid animation unless it communicates useful state.
  • Never use colour as the only status signal.

2. Light mode

Token Value Purpose
--page #F6F8FB Main page background
--page-accent #E8EEF6 Subtle page depth
--surface #FFFFFF Cards and dialogs
--surface-alt #EEF3F8 Inputs and secondary regions
--surface-strong #DCE6F0 Selected and elevated elements
--text #243142 Main text
--muted #687486 Secondary text
--border #CBD6E2 Borders and dividers
--primary #4D6F98 Main action and brand colour
--primary-hover #385777 Primary hover and active state
--secondary #E2E8EF Secondary action
--secondary-hover #D2DCE6 Secondary hover state

3. Dark mode

Token Value Purpose
--page #020509 Main dark background
--page-accent #07101A Background depth
--surface #0D1824 Cards and dialogs
--surface-alt #142333 Inputs and secondary regions
--surface-strong #21384E Selected and elevated elements
--text #F1F5FA Main text
--muted #B9C4D0 Secondary text
--border #344D66 Borders and dividers
--primary #7598C2 Main action and brand colour
--primary-hover #5F83AF Primary hover and active state
--secondary #405A73 Secondary action
--secondary-hover #526F8A Secondary hover state

4. Colour roles

Primary

Use the primary colour for main actions, active navigation and trustworthy emphasis.

Good uses:

  • main button
  • active navigation
  • selected controls
  • important links
  • compact brand details

Do not use it on every surface. The primary colour should answer:

What should I do next?

Secondary

Use the secondary colour for supporting controls, toolbars and optional actions.

Good uses:

  • secondary buttons
  • optional actions
  • toolbars
  • supporting cards
  • inactive navigation

The secondary colour should answer:

What else can I do?

Supporting accents

Role Light Dark
Accent 1 #7F8FB5 #9A9FC6
Accent 2 #6F9697 #81A7A7
Accent 3 #C6A66E #D0B17B
Success #668A73 #90B29A
Danger #A8646E #D3929A

Use only one supporting accent inside a component unless there is a strong reason to use more.

A useful page-level balance is:

  • 70% neutral backgrounds and surfaces
  • 20% primary and secondary structure
  • 10% supporting accents and status colours

5. Typography

--font-body:
  "Atkinson Hyperlegible",
  "Segoe UI",
  Arial,
  sans-serif;

--font-ui:
  "Lexend",
  "Segoe UI",
  Arial,
  sans-serif;

Use Atkinson Hyperlegible for paragraphs, instructions, tables and form help.

Use Lexend for headings, buttons, navigation and labels.

Recommended sizes:

Element Size
Body text 18px
Small text 1415px
Form labels 1617px
Buttons 1618px
H1 4264px
H2 2838px
H3 2126px

Reading rules:

  • body line-height around 1.6
  • paragraphs below roughly 70ch
  • left-aligned body text
  • no long all-caps passages
  • bold used selectively
  • short, concrete headings

6. Layout and spacing

Use an 8-pixel rhythm.

4px   tiny adjustment
8px   closely related elements
16px  normal component spacing
24px  groups inside a section
32px  separation between sections
48px+ major page regions

Recommended widths:

  • forms: 400480px
  • reading content: 680760px
  • application layouts: 10401200px

Keep one clear purpose per card. Avoid deeply nested cards and heavy borders.


7. Components

Primary button

background: var(--primary);
color: var(--on-primary);

Use one obvious primary action per task area.

Secondary button

background: var(--secondary);
color: var(--on-secondary);

Use for optional or reversible actions.

Inputs

background: var(--surface-alt);
border: 1px solid var(--border);
color: var(--text);

On focus:

border-color: var(--primary);
outline: 3px solid var(--focus);

Validation

  • Put errors beside the affected field.
  • Explain how to fix the problem.
  • Preserve entered information.
  • Use text or icons as well as colour.
  • Reserve the danger colour for genuine errors or destructive actions.

8. ADHD-friendly interaction rules

  • Present one main task at a time.
  • Reduce optional decisions near the primary button.
  • Keep related controls physically close.
  • Use consistent action placement.
  • Preserve entered data after errors.
  • Avoid unexpected layout movement.
  • Respect prefers-reduced-motion.
  • Keep notifications short and actionable.
  • Use progressive disclosure for advanced options.
  • Do not hide critical actions behind unlabeled icons.

9. Accessibility checks

Before release:

  • Test keyboard navigation.
  • Verify visible focus states.
  • Check text and button contrast.
  • Test at 200% zoom.
  • Connect labels to form controls.
  • Use semantic HTML before ARIA.
  • Test light and dark modes separately.
  • Check error messages with assistive technology when possible.

10. Quick tokens

:root {
  --page: #F6F8FB;
  --surface: #FFFFFF;
  --surface-alt: #EEF3F8;
  --text: #243142;
  --muted: #687486;
  --border: #CBD6E2;
  --primary: #4D6F98;
  --secondary: #E2E8EF;
}

html[data-theme="dark"] {
  --page: #020509;
  --surface: #0D1824;
  --surface-alt: #142333;
  --text: #F1F5FA;
  --muted: #B9C4D0;
  --border: #344D66;
  --primary: #7598C2;
  --secondary: #405A73;
}

11. Final rule

When the design starts to feel busy, remove emphasis before adding another colour.

The primary colour should identify the next action. The secondary should support it. Neutral surfaces should make the interface feel calm, stable and readable.