White label branding

Keanan treats branding as configuration, and every surface reads from the same source. An admin sets it in the dashboard under Settings, Branding: product name, company name, contact email, website, address, a logo (PNG, JPG or WebP up to 2 MB) and the colour theme. Anything saved there overrides the environment, and the mobile app refreshes it every time it launches or returns to the foreground.

Settings, Workspace holds the workspace defaults: the currency for new expense claims, the starting time off balance for new employees, and whether admins and managers must sign in with a one time email code.

The environment fallback

Scripted deployments can seed the same values through environment variables. They apply whenever the matching dashboard field is empty.

Variable	Controls
BRAND_PRODUCT_NAME	Product name in apps, emails and API docs
BRAND_COMPANY_NAME	Company name in emails and PDF footers
BRAND_COMPANY_ADDRESS	Legal address on invoices and emails
BRAND_COMPANY_EMAIL	Contact address shown to employees
BRAND_WEBSITE	Link target in email footers
BRAND_COLOR_PRIMARY	Primary color for emails and PDFs
BRAND_COLOR_PRIMARY_DARK	Dark variant of the primary color
BRAND_COLOR_ACCENT	Accent color for emails and PDFs
BRAND_LOGO_PATH	Logo file used on generated PDFs

How clients consume it

The public endpoint returns the active branding:

GET /api/v1/branding/

{
  "product_name": "NordwindHR",
  "company_name": "Nordwind Logistik GmbH",
  "color_accent": "#4C7DE0"
}

The admin dashboard requests this at load and renders the name and logo from it. The employee app does the same. Because the value comes from the server, rebranding never requires a client release.

A worked example

export BRAND_PRODUCT_NAME=NordwindHR
export BRAND_COMPANY_NAME="Nordwind Logistik GmbH"
export BRAND_COMPANY_EMAIL=people@nordwind.example
export BRAND_COLOR_ACCENT="#4C7DE0"

Restart the web container and the platform introduces itself as NordwindHR: welcome emails, invoice PDFs, the dashboard sidebar and the sign in screen included.