Branding and white label

Put your own logo, colours, fonts and browser title on every screen, without editing a single file.

Admin. Open Branding. Everything on this page is stored in the database and in protected storage, not in the source files, so it survives an upgrade untouched.

Logo and favicon

AssetRequirements
LogoPNG or JPEG. Square: the width and the height must be equal. Up to 4096 pixels a side.
FaviconPNG or JPEG. Square. Up to 1024 pixels a side. 512 by 512 is a good size.

The file type is detected from the content, not from the file name, so an image with the wrong extension is still accepted and something that is not an image at all is refused. Both files are stored under storage/private/branding and served through the application, never as a public file with a guessable name.

Colours

Seven colours, each a six-digit hex value such as #0F766E. The picker and the text box stay in step, so you can paste a value from a brand guide.

ColourUsed forDefault
PrimaryButtons, links, the selected item in the navigation, the ring around a focused field, and every other accent tint.#0F766E
Primary hoverThe same elements under the pointer. Keep it darker than the primary.#0B5C56
NavigationThe administration navigation bar.#172033
TextBody text.#1F2937
MutedSecondary text, help text, table headers.#667085
BackgroundThe page behind the content.#F7F8FA
SurfaceCards, panels and tables.#FFFFFF

Keep the contrast. Text on surface and text on background both need to stay readable. A pale primary colour on a white surface makes buttons hard to see, and there is no separate button-text colour to compensate with.

Every accent in the interface is mixed from the primary colour rather than stored separately, so one value changes the buttons, the selected navigation item, the focus ring and the page washes together. Until an installation saves this screen once it uses the shipped palette, which is why a fresh installation looks teal.

Fonts and sizes

Three font families ship with the product and are the only ones offered, because they are bundled locally rather than fetched from a font service and they cover Latin, Cyrillic and Greek.

Body size is 12 to 20 pixels, heading size 24 to 56. Values outside those ranges are refused rather than silently clamped.

Browser title

Up to 90 characters. It is what appears in the browser tab and in a bookmark, on public pages as well as inside the administration area.

What branding does not change

White labelling completely

  1. Set APP_NAME to your own name in .env.
  2. Upload your logo and favicon, set the seven colours and the browser title.
  3. Open Translations as an Admin and set the organisation name, which is what public pages and certificates show as the issuing body.
  4. Check a public certificate page and one email preview. Those are the two surfaces an outsider sees.

Nothing in the interface, the emails or the certificates names the product author, so a finished installation carries your identity only.