White-Label Branding

Every Harmonia org can be re-skinned. Agencies and resellers usually want the app to look like their own product when their clients log in — Harmonia supports that without forcing you onto a separate tier or contacting sales.

What you can customize

Settings → Branding. Owners only.

• App name — replaces "Harmonia" in the topbar, browser tab, and email signatures.
• Logo — uploaded to Supabase Storage; rendered in the topbar and on the login screen.
• Favicon — same upload widget; auto-resized to standard favicon sizes.
• Primary color — the accent color used across buttons, active nav items, and focus rings. Pick a hex value or use the picker.
• Login background — full-bleed image on the login and registration screens. Optional.
• Email-from name and address — the From line on transactional emails. (Sending domain still has to be verified separately — see Email Authentication.)

Per-org, not per-user

Branding is set at the org level. Every member of the org sees the same skin. If you're an agency with multiple client orgs, each one has its own branding — they can be totally different.

If a user belongs to multiple orgs, the brand switches when they switch orgs. The org switcher in the topbar always shows the current branding.

What stays Harmonia

We don't yet swap:

• The /docs site you're reading. Documentation is cross-tenant.
• Outbound webhook payloads (they still identify as Harmonia for security/audit purposes).
• The /platform admin console (only platform admins ever see it).
• Internal API error messages.

If white-labeling these matters for your reseller motion, get in touch — we can prioritize.

Vanity domains

Hosting your client orgs under your own domain (e.g. crm.yourbrand.com) is supported on the Agency plan. You point a CNAME at Harmonia, we issue a cert, and your clients log in at your URL. Branding still works the same — but now the URL bar matches the skin too.

How dark mode interacts

Branding colors apply to both light and dark mode. The primary color you set is used as-is in both. If your brand color has very low contrast against either background, the app's focus ring may look faint — pick something with at least 4.5:1 contrast against both #ffffff and #0f172a for full accessibility.

Restoring defaults

Hit Reset to Harmonia defaults at the bottom of the Branding page. Confirms once, then reverts every value to the shipped defaults. Doesn't delete your uploaded assets — they stay in storage if you want to re-apply later.