#Themes

Sero stores the selected theme and light, dark, or system mode in the active profile's layout state. Custom theme presets are also profile-scoped.

#Selecting a theme

Open Themes from the command menu. Select Default or a saved preset. Use the mode control to select light, dark, or system mode. Sero applies the selection immediately and restores it when you next open the profile.

#Editing a theme

Select the preset that you want to change before you open its editor. Use New Theme when you want to create a custom preset. The editor previews changes while it is open and saves custom preset data through the theme service.

Color tokens control the shell and plugin surfaces that use those tokens.

Check the preview before you close the editor. Confirm that text, borders, and status colors remain clear in the selected mode.

#Checking theme coverage

Sero has a local styleguide app for testing theme behaviour away from the main desktop shell and plugin runtime:

pnpm styleguide

Use the Diagnostic Swap preset to catch token mistakes. Brand accents should use primary or secondary brand tokens. Success, warning, error, and code colours should only change the UI they describe.

#Related docs

• Settings and Admin
• Workspace and Chat
• State and Folders