Skip to content

Devantler Tech branding across self-hosted UIs #5053

Open
5 of 7 issues completed
Open

Description

@devantler

🤖 Generated by the Agentic Engineer (interactive Claude Code session)

Why

The maintainer asked for the platform's web pages and dashboards to look like Devantler Tech
instead of a set of stock tools: the near-black and neon-green style of
devantler.tech, with the green orb logo
(favicon.png, also the GitHub organisation avatar).

Only the front page (Homepage) carries the brand today. Every other page a person opens shows its
upstream product's own look, and the sign-in path shows stock pages.

What was checked

Every self-hosted tool the platform deploys with a web page people open (an HTTPRoute, or a route
through the single sign-on proxy), at the exact version running in production on 2026-10-18. For
each one: the supported ways to change its theme or CSS, logo and favicon, product name, and
sign-in page, taken from upstream documentation and source at that version. Forks and patched builds
were ruled out from the start.

Tool Version Branding mechanism Effort Risk Verdict
Dex (login form) v2.46.0 (chart 0.26.0) frontend settings: theme, logo URL, custom template directory — High: every app's sign-in In progress in a separate session; link its issue or PR here when it exists
oauth2-proxy (single sign-on proxy) v7.15.5 (chart 10.7.1) A mounted error.html through custom_templates_dir, plus footer. Its sign-in page is skipped by configuration (skip_provider_button), so the error page is the only page of its own anyone sees M High: every SSO app sits behind it Do — #5056
Homepage (front page) v1.12.3 (chart 4.11.1) settings.yaml title, favicon, theme, colour, plus custom.css XS Low Done; moves onto the brand kit — #5054
Policy Reporter UI 2.9.0 (chart 3.11.0) Chart values ui.displayMode, ui.logo.path with ui.extraVolumes, ui.name S Low Do — #5055
Actual Budget 26.10.0 (chart 1.9.5) Custom themes: one block of --color-* variables, installed from the app's settings and saved per device. Behind the upstream experimental flag customThemes. No logo option S Low: browser-side only, validated by the app Do — #5058
Headlamp v0.42.0 (chart 0.42.0) A self-built plugin using registerAppTheme and registerAppLogo M Medium: plugin loading is switched off on purpose, for supply-chain reasons Not worth it — Headlamp is being retired (#2496)
Coroot 1.22.2 (operator chart 0.10.6) None. The interface is compiled into the binary; no theme, logo or CSS option — — Unsupported
OpenBao UI 2.6.3 (chart 0.29.6) None. Its UI configuration is an on/off switch — — Unsupported
Hubble UI v0.13.6 (Cilium 1.20.2) None documented — — Unsupported
Umami 3.2.0 (chart 2.3.0) None. No product-name, logo or CSS setting; each user picks light or dark — — Unsupported
Crossview v4.6.0 (chart 4.6.0) None documented — — Unsupported
Whoami v1.12.0 (chart 6.1.0) Plain-text diagnostic echo — — Not worth it
KSail web UI (operator) v7.202.53 Our own product, styled in its own repository — — Out of scope: a product decision for devantler-tech/ksail, not a platform override
KHoist (data-product-controller) pages 2.9.1 Our own product, styled in its own repository — — Out of scope: a product decision for devantler-tech/data-product-controller
FleetDM chart v7.0.28 Organisation name and logo in Fleet's own settings — — Revisit: switched off in production
Longhorn UI, Alertmanager, Flux Operator web UI, Chaos Mesh dashboard — — — — Nothing to do: none has a public route

Approaches considered and rejected

  • Rewriting each app's HTML at the sign-on proxy to inject the brand CSS. It needs a
    third-party proxy plugin, breaks on compressed or streamed responses, and depends on each app's
    undocumented page structure, so any upstream release can undo it. In effect it is a fork.
  • Forking or patching any upstream interface. Every update would need the patch carried
    forward by hand.

The plan

  1. Shared brand kit (Shared Devantler Tech brand kit: vector logo, favicon set and colour tokens for platform UIs #5054): one vector logo, a favicon set and one CSS variables file, kept
    in one place in this repository. Every branded page takes its logo and colours from it, so the
    brand changes in one spot. It also closes two gaps: there is no vector logo yet, and the front
    page loads its icon from the GitHub avatar URL.
  2. Policy Reporter UI (Brand the Policy Reporter UI: dark mode, logo and cluster name #5055), Actual Budget (Devantler Tech theme for Actual Budget #5058) and the sign-on proxy's
    error page
    (Brand the single sign-on proxy's error page (oauth2-proxy) #5056) each take the kit, using only options their upstream supports.
  3. Dex is handled in the separate session above, and should take the kit's logo and colours too.

Order by value for effort: the brand kit comes first because the other three are blocked by
it. After it: Policy Reporter (small, low risk, settings only), then Actual Budget (small, low risk,
but installed by hand on each device), then the sign-on proxy's error page. That last one only
appears when something goes wrong and carries the most risk, so it goes last and gets the most
testing.

How we know it worked

Each sub-issue closes with screenshots of the branded page in production. This epic closes when
every "Do" row is done and the Dex work has landed. Tools marked Unsupported are re-checked at
the product's next strategy review, in case an upstream release adds a branding option.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Fields

    No fields configured for Epic.

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions