Usage
This is ****
Settings → Plugins → Cast sets the site-wide default and which themes users can pick from. Users choose their own under Account → Preferences → Colour mode.
Auto is a pair, not a theme. Anyone set to Auto gets the two themes configured on the Auto tab, so the Default theme has no effect on them. That pair is the starting point rather than the last word: a user who can pick their own theme can also name their own light or dark half, and either half falls back to the admin's if the theme it names goes away.
If the picker doesn't appear on the preferences screen, run
php craft clear-caches/compiled-templates. Cast renders it through Craft'scp.users.edit.prefshook, and a stale compiled template silently skips it.
Bundled themes #
| Theme | Scheme | Notes |
|---|---|---|
| Dark | Dark | Neutral dark CP. The reference implementation. |
| Dim | Dark | Softer and lower contrast, for long sessions. |
| Stone | Light | A warm neutral, based on Tailwind's stone ramp. |
| Stone Dark | Dark | The same warm neutral, but.. dark. |
| High Contrast | Light | Near-black text, solid borders, widened focus ring. |
| High Contrast Dark | Dark | The same treatment on a near-black canvas. |
Button colour #
Repoints the fill of Craft's primary buttons at one of nine colours. Beyond primary buttons, --bg-primary reaches only the Plugin Store's cart badge and the installer's step dots.
Each is shaded per mode so the white label clears WCAG AA against the fill (≥4.5:1 light, ≥4:1 dark). Black/White carries its own label colour so it can swap ends with the mode. Amber is a knowing compromise at 3.19:1 — the only warm colour distinct enough from the default that keeps a white label. Status colours stay red.