White Label

Rebrand TotalApp for your organisation or clients — app name, logo, colours, custom themes, and social links.

What is White Label?

White Label lets you present TotalApp under your own brand identity — no source code changes required. Every setting is applied in real time and affects all users on the same TotalApp instance immediately.

App Name

Replace "TotalApp" with your company name throughout the UI — browser tab, header, welcome messages.

Logo

Upload your own full and small logo variants for the sidebar and header bar.

Primary Colour

Change the accent colour used across buttons, active states, progress bars, and AI panel highlights.

Custom Themes

Override any CSS design token per theme without touching source files.

Social Links

Configure social media URLs shown in the app footer for your organisation.

Where to Find White Label Settings

White Label is a dedicated section in TotalApp — accessible from the sidebar (look for the White Label icon) or by navigating to Settings → White Label in the in-app settings panel. It is intentionally separate from the regular Settings tabs because it controls instance-wide branding rather than per-user preferences.

Instance-wide scope

White label settings apply to the entire TotalApp instance — all users on the same server see the same branding. They are persisted server-side at /api/data/white-label.json and loaded on every page open.

Quick Start

Open White Label from the sidebar.
Enter your App Name — this appears in the browser tab and header.
Upload your Full Logo (for expanded sidebar) and Small Logo (for collapsed sidebar).
Pick your Primary Colour using the colour picker or by typing a hex code.
Optionally configure Custom Themes for advanced CSS token overrides.
Add Social Links for your company's profiles.
Changes save automatically — no Save button required.

Resetting to Defaults

To revert to TotalApp's default branding, clear all custom fields in the White Label panel and save. The app name, logos, and primary colour return to their built-in values. Custom theme overrides must be deleted manually from the theme editor.

In This Section

Page	What it covers
Overview	Introduction, quick start, scope, and reset instructions (this page).
Branding	App name, logo upload (full & small), and primary accent colour.
Custom Themes	CSS token override editor for per-theme customisation without code changes.
Social Links	Social media URLs displayed in the app footer.

Frequently Asked Questions

Does White Label apply per-user or for the whole instance?

White Label settings are instance-wide, not per-user. Once you set an app name, logo, or primary colour, every user who logs into that TotalApp instance sees the same branding. This is different from personal appearance preferences (like light/dark theme), which remain per-user. Settings are persisted server-side at /api/data/white-label.json and loaded on every page load.

Do I need to touch any source code or redeploy to change branding?

No. All White Label changes — app name, logo uploads, primary colour, custom theme tokens, and social links — are applied in real time through the in-app settings panel. There is no build step, no redeploy, and no code change required. Changes save automatically as you edit each field.

What logo formats and sizes are supported?

You can upload two logo variants: a Full Logo (shown when the sidebar is expanded) and a Small Logo (shown when the sidebar is collapsed, typically a square icon-style mark). See the Branding page for supported file types and recommended dimensions.

How do I undo my White Label changes and go back to TotalApp's default branding?

Clear all custom fields (app name, logos, primary colour) in the White Label panel and save — the app reverts to its built-in TotalApp branding. Custom theme token overrides configured under Custom Themes are not cleared automatically and must be removed individually from the theme editor.