Repository navigation
Description
🤖 Generated by the Agentic Engineer (interactive Claude Code session)
Part of #5053.
Problem
Every platform page that can be branded needs the same logo, icons and colours. Without one shared
source, each page would carry its own copy and they would drift apart. Three gaps exist today:
- The only logo is a 256×256 PNG of the green orb (
favicon.png).
There is no vector version, so it blurs at large sizes and cannot be recoloured. - The front page (Homepage) loads its icon from the GitHub avatar URL instead of a file we keep.
- The palette has two dark backgrounds. devantler.tech's page background is the stock Starlight dark,
which Homepage reproduces ashsl(224, 10%, 10%), while#050a08is the tint of the site's hero
overlay. The kit needs one background value.
Proposal
A Kustomize component, k8s/bases/components/brand-kit/, whose configMapGenerator builds a
brand-kit ConfigMap from files in files/. Any namespace that includes the component gets an
identical copy, and the generated name suffix restarts the pods that mount it when a file changes.
| File | What it holds |
|---|---|
logo.svg |
A vector trace of the green orb, checked against the PNG at 32 px and 256 px |
logo-256.png, favicon.ico (16, 32, 48), favicon-32.png, apple-touch-icon.png (180), icon-512.png |
The raster and favicon set, exported from logo.svg |
tokens.css |
One :root block of brand values: --dt-bg (decide it here and say why in a header comment), --dt-accent: #39ff14, --dt-accent-high: #7aff6e, --dt-accent-low: #0a2e14, --dt-card-border: rgba(255, 255, 255, 0.12), --dt-glow: rgba(57, 255, 20, 0.3), --dt-accent-light: #15803d (light theme) |
Some consumers can only take literal values, not a linked file. Actual Budget's theme validator
accepts plain values only, and the sign-on proxy's error page has to inline its styles because the
proxy serves no files of its own. A small CI check (Bash or Go, per the platform's scripting rules)
therefore compares every brand value a consumer inlines with tokens.css and fails on a mismatch.
The tokens stay the single source, and a drifted copy cannot merge.
First consumer: Homepage. Mount the kit under Homepage's public folder; it serves local files
from /app/public. Point favicon at the kit's icon instead of the GitHub avatar, and have its
custom.css use the kit's values. Its existing look stays as it is, apart from the background
decision above.
The kit is permanent configuration, so it needs no feature flag (see the platform's flag guidance).
Reverting the PR restores the current state.
Acceptance criteria
- The component renders a
brand-kitConfigMap in every namespace that includes it (shown in thekubectl kustomizeoutput of each consuming layer). -
logo.svgmatches the PNG orb: a side-by-side screenshot at 32 px and 256 px is in the PR. - Every favicon-set file exists at its stated pixel size.
-
tokens.cssholds exactly the values above, and its header comment records the chosen--dt-bgand why. - The CI check fails on a deliberately mismatched consumer value and passes on the real tree. Both runs are shown in the PR.
- Homepage uses the kit's favicon and values. Before and after screenshots of the production front page are attached, and the browser tab shows the orb icon.
- A short platform docs section names the component and explains how to add a new consumer.
Size: M (the vector trace is the uncertain part).
Metadata
Metadata
Assignees
Labels
Type
Fields
Priority
Start date
Target date
Effort
Projects
- StatusShow more project fields📥 Backlog
Activity
docs(branding): record the Devantler Tech logo's vector source
devantler commentedon Nov 15, 2026
The brand kit now has its vector logo. The maintainer approved the final design on 2026-11-15:
#39FF14(#5BFF3Cto#2CE00E), with a fine white edge highlight.#F1F5F1and "Tech"#39FF14. On light backgrounds, they are#0A0D0Band#15803D.The palette is unchanged. This replaces an interim "DT orb" design that an earlier version of this comment described.
Vector source:
devantler-tech-icon.svg,devantler-tech-logo-dark.svganddevantler-tech-logo-light.svgin devantler-tech/business-sitesrc/assets/brand/(business-site#612). The letters are Inter (SIL Open Font License), converted to outlines.Where it is used: #6361 adds
docs/brand.md, which says which file to use where and lists every copy. That PR also moves Homepage off the GitHub avatar URL and gives Dex the icon and wordmark. The ZITADEL label policy follows in its own PR.One finding changes this issue's proposal. KSail publishes only YAML and JSON files (see
k8s/bases/apps/private-mail-proxy-identity/kustomization.yaml). So aconfigMapGeneratorthat reads SVG or PNG files fromfiles/builds locally but never reaches production. Each consumer therefore embeds the files it needs in its own ConfigMap.Still open here: the single
--dt-bgdecision,tokens.css, and the drift check for inlined values. Keep them only if a second consumer of the colours needs them.🤖 Generated with Claude Code