Skip to content

Persistent theme choice

As a case manager, I want to switch between dark and light themes and have my choice remembered so that I can use the portal under whatever lighting condition I’m in without re-toggling every visit.

A sun/moon button in the top bar flips between dark and light themes. The choice is persisted to local storage and applied before paint, so the manager’s last-chosen theme is present from the first frame on every reload — no flash of the opposite theme on load.

Any page → click the sun/moon icon in the top bar → reload the page. The chosen theme persists.

Light theme matches the live-software reference screenshots that managers already work from, so it has to feel native — and a flash of the wrong theme on every load breaks that feeling. Reading the saved theme from local storage before the app paints (rather than after the React app mounts) eliminates the flash entirely.

No dedicated feature page — theme is a global behavior that applies across every screen documented in this site.