Skip to content

Devantler Tech theme for Actual Budget #5058

Description

@devantler

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

Part of #5053.

Problem

Actual Budget is the maintainer's personal-finance app on the platform, and it shows its stock light or dark
theme.

What the deployed version supports

Actual Budget 26.10.0 (chart 1.9.5) has custom themes:

  • They sit behind the upstream experimental flag customThemes, which is off by default and
    switched on per budget under Settings → Experimental. Upstream warns that experimental features
    can change or be removed.
  • A theme is exactly one :root { … } block of --color-* variables, such as
    --color-pageBackground, --color-buttonPrimaryBackground, --color-sidebarBackground,
    --color-pageTextLink and --color-chartQual1. The app validates it before installing:
    no @import, no url(), no nested rules, and plain values or var(--…) only.
  • Themes are installed from the app's settings: by owner/repo (it fetches actual.css from that
    repository's root on main), by direct URL, or by pasting the CSS. The choice is saved in the
    app's per-device preferences, not in Git, so each device installs it once.
  • There is no logo option; only colours change.

Proposal

Add actual.css to the brand kit. Map the kit's values onto the dark theme's keys at v26.10.0
(packages/desktop-client/src/style/themes/dark.ts): the near-black background for page, sidebar
and tables; green for primary buttons, links and the first chart colour; and the existing greys for
text. Install it on the maintainer's devices, and document the install and the rollback
(choosing a built-in theme) next to the brand kit.

Acceptance criteria

  • actual.css installs without a validation error in the production app.
  • It sets every background, text, button, sidebar, link and chart key that the v26.10.0 dark theme defines, so no stock blue is left on the budget, accounts or reports pages.
  • Body text and amounts meet at least 4.5:1 contrast against their backgrounds.
  • Screenshots of the budget page and one report, with the theme installed, are attached.
  • The brand kit's drift check covers the values in actual.css.
  • A short docs note explains how to install the theme and how to switch back.

Risk: Low. It runs in the browser only, the app validates it, and switching to a built-in theme
undoes it. The real risk is upstream removing the experimental feature; if that happens, close this
as superseded.

Size: S.

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