Repository navigation
Description
🤖 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-pageTextLinkand--color-chartQual1. The app validates it before installing:
no@import, nourl(), no nested rules, and plain values orvar(--…)only. - Themes are installed from the app's settings: by
owner/repo(it fetchesactual.cssfrom that
repository's root onmain), 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.cssinstalls 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
Labels
Type
Fields
Priority
Start date
Target date
Effort
Projects
- StatusShow more project fields📥 Backlog
Activity