Skip to content

Theming

Customise the appearance of your Aire Innovate products by updating logos, background images, and application colour palettes.

The Theming page is divided into two tabs: Images and Colours.

Images

Update the primary branding assets used throughout the application.

Actions available:

  • Upload — Add a new image if none exists
  • Replace — Swap the current image with a new file
  • Remove — Clear the current image and revert to the default branding

Supported formats

PNG, JPEG, and WebP.

Upload or replace the logo displayed in AireFrame.

The recommended logo size is dependent on your layout, but high-resolution files are preferred for crisp rendering.

Login Background Image

Customise the image shown behind the login form.

This is optional and can be used for:

  • Organisational branding
  • Hospital or trust imagery
  • Campaign or seasonal backgrounds

The preview area shows whether an image is currently set.

Colours

Control the look and feel of AireFrame by selecting from preset themes or creating your own colour set.

Preset Themes

Choose from predefined, professionally-designed themes:

  • AireFrame Theme — Default colours for Aire Innovate
  • NHS Styled Theme — Based on NHS design standards
  • GDS Styled Theme — Inspired by UK Government Design System colours

Each theme preview shows examples of headings, text, components, and accents so you know exactly what the palette will look like.

Selecting a preset will automatically apply the associated colour values.

Customise Theme

For full control, manually configure your colour palette:

  • Primary — The dominant interface colour (buttons, highlights, links)
  • Secondary — Supporting accents
  • Background — Page background colour
  • Primary Text — The dominant text colour (titles, headings)
  • Secondary Text — Supporting text accents (subtitles)

Alert Colours

Configure the colours used for alerts across AireBlocks products such as AireForms. These colours control the appearance of contextual alerts and hightlights that communicate status information to users.

  • Information — Used for informational messages and general notices
  • Success — Used to confirm a successful action or positive outcome
  • Warning — Used to highlight something that requires attention but is not critical
  • Danger — Used for errors or critical issues that need immediate action

Each preset theme includes sensible defaults for these colours, but they can be customised individually to match your organisation's branding or accessibility requirements.

TIP

The alert colour preview shows how each alert will appear.

WCAG Accessibility Checking

When customising colours, the configurator automatically validates your palette against WCAG 2.1 contrast requirements. This helps ensure that text and UI elements remain readable for all users, including those with visual impairments.

What is WCAG?

The Web Content Accessibility Guidelines (WCAG) define minimum contrast ratios between foreground and background colours:

  • AA Large — 3:1 ratio for large text and UI components
  • AA — 4.5:1 ratio for normal-sized text (the standard target)
  • AAA — 7:1 ratio for enhanced contrast

Accessibility Score

As you adjust colours, an accessibility summary appears alongside your chosen theme showing:

  • A score indicating how many colour pairs pass (e.g. 8 / 10)
  • The number of WCAG issues found
  • A coloured border that glows green when all pairs pass, or highlights issues when failures are detected

Contrast Breakdown Table

The Accessibility section displays a full breakdown table of every colour pair that is checked. Pairs are grouped into three categories:

App Colours

PairWhat it checks
Primary / BackgroundPrimary colour against the page background
Secondary / BackgroundSecondary colour against the page background
Text / PrimaryAuto-selected text colour on primary surfaces
Text / SecondaryAuto-selected text colour on secondary surfaces

Text Colours

PairWhat it checks
Primary Text / BackgroundMain text colour against the page background
Secondary Text / BackgroundSupporting text colour against the page background

Alert Colours

PairWhat it checks
Text / Information AlertText readability on information alert backgrounds
Text / Success AlertText readability on success alert backgrounds
Text / Warning AlertText readability on warning alert backgrounds
Text / Danger AlertText readability on danger alert backgrounds

For each pair, the table shows the foreground and background colour swatches, the computed contrast ratio, and pass/fail indicators for AA Large, AA, and AAA levels.

Accessible Theme Suggestions

If your theme has contrast issues, click the Suggest Theme button to open a dialog with three auto-generated alternatives derived from your primary colour. All suggestions are guaranteed to meet WCAG AA (4.5:1) on every contrast pair.

SuggestionDescription
Accessible fix (recommended)Your existing palette with only the failing colours adjusted to meet contrast requirements
Warm complementA darker secondary creates visual separation from the primary colour, with a lighter background
High contrastDeeper tones on a white background for maximum readability

Each suggestion includes a live preview. Select one and click Try out to apply it — you can continue to fine-tune before saving.

Saving with Accessibility Issues

When saving a theme, a confirmation dialog will appear reminding you that changes apply across all environments for the tenant. If your theme has outstanding WCAG issues, you can still save, but the accessibility score will remain visible so you can address issues later.