Skip to content
Design system guidelines
Colour palette and accessibility
-
Standardised colors:
- Teal (#00B7B7): Use with dark text (#000000 or #333333) for 4.5:1 contrast ratio.
- Dark Purple (#4B0082): Use with white (#FFFFFF) or light text (#E6E6E6) for 4.5:1 contrast.
- Magenta (#C71585): Adjust to accessible shade or restrict from buttons/backgrounds unless meeting 4.5:1 (normal text) or 3:1 (large text) contrast.
-
Logo: Retain original house style colours (no text, no accessibility impact).
-
Consistency: Use defined text/background pairings across all UI elements (buttons, text fields, links).
-
Documentation: Update style guide with accessible colour combinations and usage rules.
Language consistency
- Use US English consistently across all content.
- Max sentence length: 20 words for readability.
- Naming conventions:
- CamelCase for variables/functions (e.g., primaryButtonColour).
- Singular nouns for components (e.g., Button, not Buttons).
- Active verbs (e.g., submitForm, not formSubmitted).
UI/UX consistency
-
Typography:
- Headings: 24px, bold (H1), 20px (H2), 18px (H3).
- Body text: 16px.
- Captions: 12px.
-
Buttons:
- Primary: #007BFF, 8px border-radius, white text (#FFFFFF).
- Hover: Darken to #0056B3.
-
Navigation: Top bar (desktop) or hamburger menu (top-left, mobile).
-
Icons: Universal symbols (e.g., magnifying glass for search, trash can for delete).
-
Feedback: Button color change on click, loading spinner for submissions.
-
Forms:
- Real-time validation (e.g., email format).
- Error messages in red below input (e.g., “Please enter a valid email address”).
-
Links: Underlined, dotted line for tooltips.
-
Responsive Design: 3-column layout (desktop, >768px), single-column (mobile, ≤768px).
-
White Space: 16px padding between elements, 32px section margins.
-
Alt Text: Descriptive, concise (e.g., “Search icon for website navigation”).
Visual hierarchy
- Use font sizes, weights, and spacing to guide attention.
- Consistent positioning: Titles left-aligned, paragraphs indented 8px.
Background usage
- Avoid magenta backgrounds unless contrast-compliant.
- Teal/purple backgrounds must follow defined text color pairings.
Repeatable behavior
- Consistent interactions (e.g., all buttons animate on hover).
- Minimise cognitive load: 1–2 primary call-to-action buttons per screen.