Struct Theme 

pub struct Theme {

    pub focus: Color,
    pub accent: Color,
    pub branch: Color,
    pub clean: Color,
    pub dirty: Color,
    pub main: Color,
    pub locked: Color,
    pub prunable: Color,
    pub muted: Color,
    pub selection_bg: Color,
    pub name: Color,
    pub path: Color,
    pub staged: Color,
    pub modified: Color,
    pub untracked: Color,
}

Role-based colour scheme for the TUI. Every field is a ratatui::style::Color; the renderer reads them via App.theme rather than hard-coding palette values.

Order of fields here matches the documented [theme] key order in examples/gwm.toml.example so the doc and the struct stay readable side-by-side.

Fields

focus: Color

Focused border / cursor / active overlay highlight. Pre-#33 hardcoded as Color::Cyan.

accent: Color

General accent: header title, key hints in the help overlay, the palette input bar prompt. Pre-#33 hardcoded as Cyan.

branch: Color

Branch name in lists and the sidebar identity card. Pre-#33 hardcoded as Green when the branch is in a healthy state.

clean: Color

“Working tree is clean” status indicator. Pre-#33 Green.

dirty: Color

“Working tree is dirty” status indicator. Pre-#33 Yellow.

main: Color

Main / trunk worktree badge. Pre-#33 Yellow.

locked: Color

Locked worktree badge (🔒). Pre-#33 Magenta.

prunable: Color

Prunable worktree badge (⚠). Pre-#33 Red.

muted: Color

De-emphasised text: hints, footers, placeholders. Pre-#33 DarkGray.

selection_bg: Color

Selection highlight background. Pre-#33 DarkGray. Kept as a separate role so themes that prefer a coloured selection background (e.g. catppuccin’s surface tone) can move it independently of muted.

name: Color

Primary identity text: the worktree name in the table and the sidebar header, plus the Issue #N / PR #N heads of the link summary lines. Pre-#170 these were a hard-coded Color::White with no semantic role (issue #210). Rendered bold at the name sites; the role only carries the foreground colour.

path: Color

Worktree path column in the table. Pre-#170 a hard-coded Color::Gray, distinct from muted (DarkGray) so the path reads as a structural mid-grey rather than dimmed text (issue #210). The sidebar identity-card path stays on muted and is intentionally not moved here — doing so would shift its default appearance.

staged: Color

Staged (index-side) git-status changes in the working-tree panel — the X column and a staged-only file name. Pre-#211 this borrowed accent; the dedicated role (default Cyan, issue #211) decouples a staged file from the focus/accent highlight.

modified: Color

Worktree-side git-status modifications — the Y column and a modified file name. Pre-#211 this borrowed dirty (a branch divergence warning); the dedicated role (default Yellow, issue #211) decouples the two unrelated signals.

untracked: Color

Untracked / created git-status entries (??). Pre-#211 this borrowed clean (the “working tree is clean” indicator); the dedicated role (default Green, issue #211) decouples them.

Implementations

impl Theme

pub fn preset(name: &str) -> Option<Self>

Resolve a built-in preset by name. Returns None for unknown names — the config loader translates None into a GwmError::Config with the candidate name + the preset_names list for the user to crib from.

pub fn apply_override(&mut self, role: &str, value: &str) -> Result<()>

Apply a single role override. Returns Err when role is unknown or value does not parse as a color. On Ok the targeted field is mutated in place.

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Theme

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Theme

impl Debug for Theme

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Theme

fn default() -> Self

Pre-#33 hardcoded scheme. Documented field-by-field above. A non-default look (e.g. the Claude orange) is opt-in via a [theme] preset = "claude-dark" block — not baked into the default, so users who never write a [theme] block see no change.

impl Eq for Theme

impl PartialEq for Theme

fn eq(&self, other: &Theme) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Theme