Team Branding

branding logo colours customization

How to customize your team branding with logos and colours

Team Branding

Give IndieBase your team's identity — upload your logo and set your colours so every record, report, and screen reflects your organisation.

Overview

The Team Branding page lets you upload a team logo and choose two brand colours (a primary and a secondary) that are applied throughout the app. Your branding appears in the main navigation header, on patient record PDFs, in patient feedback forms, and in the team switcher — so anything bearing your team's name also carries your colours.

Branding settings are scoped to your team, so each team in IndieBase can have its own distinct look.

Before You Start

  • You must be a team admin to access branding settings.
  • Team Branding requires a Team plan subscription. If you're on a lower tier, the Branding link won't appear in the sidebar.
  • Have your logo file ready. See Logo requirements below for the spec.

How to Get There

In the left-hand sidebar, expand the Configuration section and click Branding.

Screenshot: The left-hand sidebar with the Configuration group expanded, showing the Branding navigation item highlighted

This opens the Team Branding page at /teams/{your-team-id}/branding.


Step 1: Open the logo uploader

On the Branding page, you'll see the Team Logo section at the top with a description and a file input. If no logo has been uploaded yet, a file picker is shown.

Screenshot: The Team Logo section showing the file input field ready for upload, with the description text visible

Step 2: Choose your file

Click the file input and select your logo from your device. The upload begins immediately once you select the file, and a progress bar appears while it's transferring.

Only image files are accepted: JPEG, PNG, WebP, and SVG. The maximum file size is 1 MB.

Step 3: Confirm the upload

Once uploaded, the file picker is replaced by a preview of your logo. The app shows it against both a Light and Dark background so you can check it reads well in both modes — use the segmented control to switch between them.

Screenshot: The logo preview area showing the uploaded logo displayed against a white (Light) background, with the Light/Dark toggle control above it and the red trash button in the top-right corner of the preview

A toast notification appears at the bottom-right of the screen confirming "Logo updated".

Logo requirements

Property Requirement
Formats JPEG, PNG, WebP, SVG
Maximum file size 1 MB
Recommended dimensions At least 200 x 200 px
Background Transparent PNG strongly recommended
Colour Should be legible on both light and dark backgrounds

A transparent PNG works best. IndieBase uses both light and dark themes, so a logo with a solid coloured background will look out of place on whichever theme it doesn't match.


To remove a logo that's already uploaded, click the red trash button in the top-right corner of the logo preview area.

Screenshot: The logo preview with the red trash (delete) button visible in the top-right corner of the preview card

A confirmation is not required — the logo is removed immediately and the file picker returns. A "Logo removed" toast notification confirms the change.


Setting Brand Colours

Below the logo section are two colour pickers: Primary Colour and Secondary Colour.

Screenshot: The two colour pickers side by side — Primary Colour on the left and Secondary Colour on the right — each showing a wide colour swatch

What each colour is used for

  • Primary Colour — used for your team name in the header, navigation links, and other prominent text elements throughout the app. Defaults to sky blue (#00a6f4).
  • Secondary Colour — used for your name in the header, icon accents, and decorative elements. Defaults to pink (#f6339a).

Both colours also appear on patient record PDFs and in patient feedback forms sent on your team's behalf.

Choosing a colour with the colour picker

Click either swatch to open your browser's native colour picker. Select your colour, then click away or close the picker — the colour saves automatically and a toast notification confirms the update.

Colours are saved as soon as you leave the colour picker. There's no separate save button for colour changes.

Using the suggested colour palette

If you'd rather pick from a predefined set than use the freeform picker, click Suggested Colours to expand the palette panel.

Screenshot: The Suggested Colours accordion expanded, showing a grid of 18 named colour swatches on the left for Primary and 18 matching swatches on the right for Secondary

The palette offers 18 colours — Red, Orange, Amber, Yellow, Lime, Green, Emerald, Teal, Cyan, Sky, Blue, Indigo, Violet, Purple, Fuchsia, Pink, Rose, and Zinc — independently for Primary and Secondary. Click any swatch to apply it immediately.


Previewing Your Branding

Colour changes take effect across the app straight away, but if you want to force a full refresh to see everything updated at once, click the Preview button at the bottom of the page.

Screenshot: The bottom of the Branding page showing the Reset defaults button on the left and the Preview button on the right

This reloads the page and applies all current branding settings.


Resetting to Defaults

To revert both colours back to IndieBase's defaults (sky blue primary, pink secondary), click Reset defaults at the bottom of the page.

Screenshot: The Reset defaults button at the bottom of the Branding page

This immediately clears any custom colours and restores the defaults. Your logo is not affected by resetting colours.


Where Your Branding Appears

Once configured, your branding is applied consistently across the following areas:

Location What appears
Main app header Your logo (if uploaded) replaces the default icon; team name and user name are coloured using your primary and secondary colours
Team switcher Each team's logo and colours appear in the team switcher dropdown, making it easy to identify teams at a glance
Patient record PDFs Your logo appears at the top of every printed or downloaded patient record
Patient feedback forms Your logo and colours brand the feedback form sent to patients
Patient feedback emails Your logo and colours are applied to the email notification sent alongside feedback requests

Troubleshooting

The Branding link doesn't appear in the sidebar. Branding is a Team plan feature. If you don't see the link, check your subscription under Billing Portal in the Configuration section of the sidebar. You'll need an active Team plan to access it.

My upload failed with a validation error. Check that your file is a supported image format (JPEG, PNG, WebP, or SVG) and is under 1 MB. Files larger than 1 MB will be rejected.

My logo looks fine in Light mode but disappears in Dark mode (or vice versa). This usually means your logo has a solid background that blends into one of the themes. Export your logo as a PNG with a transparent background so it works on both light and dark interfaces.

I changed my colours but the header still shows the old ones. Try clicking the Preview button on the Branding page to force a full page reload, which re-applies the latest colour settings.

I reset the defaults but my secondary colour still looks wrong. After clicking Reset defaults, click Preview to reload the page and fully apply the changes.


Related Features

  • Team Settings — manage your team name, address, and membership from the Team Settings page
  • Template Config — configure clinical record options and feature toggles for your team
  • Custom Panels — add bespoke data panels to patient records