Skip to content

Brand the Policy Reporter UI: dark mode, logo and cluster name #5055

Description

@devantler

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

Part of #5053.

Problem

The Policy Reporter dashboard shows the stock Kyverno look: the upstream logo, the theme the
browser happens to prefer, and the cluster named Default.

What the deployed version supports

Policy Reporter UI 2.9.0, Helm chart 3.11.0 (k8s/bases/infrastructure/policy-reporter/helm-release.yaml).
The chart's ui values, which it renders into the UI's config, include:

  • ui.displayMode: dark, light, colorblind or colorblinddark. Empty means the browser's preference.
  • ui.logo.path: a custom logo file; ui.logo.disabled removes the logo.
  • ui.name: the default cluster's display name.
  • ui.banner: optional banner text.
  • ui.extraVolumes.volumes and ui.extraVolumes.volumeMounts: mount extra files into the UI pod.

There is no accent-colour or custom-CSS option, so beyond dark mode and the logo the UI keeps
its own colours.

Proposal

ui:
  displayMode: dark
  name: <the production cluster's name>   # replaces "Default"
  logo:
    path: /brand/logo-256.png             # or logo.svg if the UI renders it sharply
  extraVolumes:
    volumes:
      - name: brand-kit
        configMap:
          name: brand-kit
    volumeMounts:
      - name: brand-kit
        mountPath: /brand
        readOnly: true

Include the brand-kit component in the policy-reporter layer so that its namespace has its own
copy. The chart also uses ui.name to build the default cluster's entry, so confirm the renamed
entry still connects to the core API before merging.

This is permanent configuration, so it needs no feature flag. Reverting the values restores today's
UI.

Acceptance criteria

  • ksail --config ksail.prod.yaml workload validate passes, and the rendered UI Deployment mounts the kit read-only.
  • After deploy, a screenshot of the production dashboard shows dark mode by default, the orb logo in place of the upstream logo, and the new cluster name. Data still loads.
  • The logo is sharp at the size the sidebar shows it (pick PNG or SVG on that basis and say which in the PR).

Risk: Low. The UI is stateless (two replicas), sits behind single sign-on, and only reads reports.

Size: S.

Activity

  1. moved this to 📥 Backlog in 🌊 Project Boardon Oct 18, 2026
  2. moved this from 📥 Backlog to 🏃🏻‍♂️ In Progress in 🌊 Project Boardon Nov 16, 2026
  3. moved this from 🏃🏻‍♂️ In Progress to ✅ Done in 🌊 Project Boardon Nov 16, 2026
  4. devantler commented on Nov 16, 2026

    @devantler
    ContributorAuthor

    Verified live after #6412 deployed (HelmRelease v12, Ready, both UI pods rolled at 11:17 UTC):

    • https://policy-reporter.platform.devantler.tech/logo.png serves the Devantler Tech icon (12,580 bytes, sha256 53ae43ad…, which equals devantler-tech-icon-180.png). It shows in the top bar's logo slot (40×40, loaded at 180 px).
    • /favicon.ico serves the new 32/64/180 px icon file (17,759 bytes).
    • /api/config reports displayMode: dark and a single cluster named prod. The dashboard's results load as before.
    • The UI pods logged a normal start and no errors.

    🤖 Generated with Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Fields

    Priority

    None yet

    Start date

    None yet

    Target date

    None yet

    Effort

    None yet

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions