Themes

A lys-shell theme is a YAML file that defines a color palette. Drop one into ~/.config/lys-shell/themes/ (or $XDG_CONFIG_HOME/lys-shell/themes/) and the settings dialog lists it alongside the built-in themes. If a file in that directory collides with a built-in name, the built-in wins and the file is skipped.

Adding a theme

The filename without .yaml becomes the theme name shown in the settings dialog. tokyo-night.yaml appears as tokyo-night.

# ~/.config/lys-shell/themes/tokyo-night.yaml
bg: "#1a1b26"
surface: "#24283b"
elevated: "#2f334d"

fg: "#c0caf5"
fg_muted: "#9aa5ce"

primary: "#7aa2f7"

red: "#f7768e"
yellow: "#e0af68"
green: "#9ece6a"
blue: "#7aa2f7"

Every key takes a hex string. The roles:

• bg - darkest base background
• surface - card and sidebar background
• elevated - raised element background
• fg - primary text
• fg_muted - secondary text
• primary - accent for interactive elements
• red, yellow, green, blue - palette accents

Palette values are referenced from elsewhere in the config via ColorValue.

Apply a theme

Open the settings dialog with lys-shell panel settings. The themes list shows every built-in theme plus every valid *.yaml file in ~/.config/lys-shell/themes/. Pick one; the shell applies it immediately.