Branding

MaxTrax can carry your organization’s own name, accent color, logo, and favicon across the app and on generated reports. Corporate Administrators set all of it from Admin → Branding.

Set your branding

Go to Admin → Branding. Everything on the page previews live as you type, and nothing is applied until you choose Save branding.

Identity

Organization name appears in the browser tab, in the app’s top bar beside the MaxTrax mark, and on report letterheads. Description is used where a longer descriptive name is needed, and is optional.

Colors

Colors are written as three numbers — hue, saturation, lightness — for example 221 83% 45%. That is the same format the design system uses internally, and it is what keeps translucent surfaces looking right. Leave a box empty to fall back to the MaxTrax default.

Accent color is the one that does the work: it paints primary buttons, links, and the active tab.

Primary color is stored for future use and does not paint anything in the app today. The page says so next to the box, so you are not left wondering why the preview didn’t change.

The contrast check

As you type, MaxTrax checks the color against the accessibility requirement for readable text (WCAG AA, 4.5:1) and shows you each result with its exact ratio:

• As text on the light page background — must pass.
• White label text on this color (buttons, chips) — must pass.
• As text on the dark page background — advisory only, and it never blocks saving. It rates the color exactly as you typed it. A single color rarely reads well on both the light and the dark page, so when yours would not, dark mode does not paint that exact color: MaxTrax automatically uses a lighter shade of the same hue, just light enough that primary buttons (and the text on them), the active tab and focus outlines all pass the same 4.5:1 check on the dark background. It lifts only as far as it has to, and a color that already passes on the dark background is painted exactly as you typed it in both modes. Your saved color is never changed, and light mode always uses it exactly as typed.

If a color fails one of the two required checks, Save branding stays disabled and MaxTrax offers a darker shade of the same color that would pass. It is only ever an offer — nothing is changed for you until you choose it. If no darker shade of that color can pass, the page says that too, rather than suggesting something that would still fail.

The check runs twice, on purpose

The same rule runs in your browser and again on the server. The server has the final say, so a color it rejects is refused even if something went wrong in the browser — and the message you get back is the server’s own wording, not a paraphrase.

Logo and favicon

Upload a logo (PNG, JPEG, or SVG, up to 2 MB) and a favicon (up to 1 MB). Choosing a new file replaces the stored one; ticking Remove clears it; doing neither leaves it unchanged. The two files together must stay under 4 MB.

The logo appears at the start of the app’s top bar, alongside the MaxTrax mark — never in place of it — and in the identity slot on report letterheads.

Links on generated reports

Generated PDFs carry a small maxtrax.io credit in the header and footer. This setting controls whether it is clickable:

• Full — maxtrax.io is a live link readers can click in the PDF.
• Text only — maxtrax.io is printed as plain text, with no outbound link.

The attribution text itself always appears

There is no option to remove the MaxTrax credit from reports. This setting controls only whether it is a clickable link. The page states this next to the choice so it isn’t a surprise.

The previews

Two previews sit above the Save button, and both repaint as you type.

Brand preview shows four cells — the Desk and Field layouts, each in light and dark mode — so you can see your color in every combination someone might be using. Weld status colors (Accepted, Rejected, Repair) are reserved and never change with your brand: a status can never be mistaken for a brand color. The two dark cells show your color exactly as typed; the app itself, in dark mode, uses the lighter shade described under the contrast check.

Report letterhead shows how a generated PDF header will look: your name or logo on the left, the MaxTrax wordmark on the right, and your accent color on the rule beneath. Your accent paints that rule and nothing else — table headers, titles, and status text keep the standard report colors. It is a close approximation, not a pixel-exact rendering of the PDF.

After you save

Branding applies immediately across the app — the tab title, the favicon, and the accent color all update without a separate “publish” step, and your own session repaints without a reload.

If someone else changed branding while you had the page open, saving stops and tells you, with a link to reload — your version never silently overwrites theirs. If part of a save doesn’t land (for example a logo upload fails while the colors succeed), the page says exactly what saved and what didn’t rather than reporting a blanket success.

Related

• Generate reports & printable labels — the reports branding appears on.
• Roles and capabilities — who can change branding.
• Admin — the rest of project setup.