Themes | GitComet Docs

Themes

Choose a GitComet theme and find where theme files are stored.

GitComet supports built-in themes and user-provided custom themes.

Built-in themes are embedded in the GitComet binary. Custom themes are JSON bundle files you place in your per-user themes directory.

Choose A Theme

Open the Settings window with Cmd+, on macOS or Ctrl+, on Windows and Linux.
In the General section, open Theme.
Choose Automatic to follow your current light or dark window appearance, or pick any theme by name to keep it regardless of appearance.

The change applies immediately after you choose a theme.

Current Built-In Themes

GitComet currently ships with:

GitComet Light
GitComet Dark
Sunset Veil (light)
Tokyo Night (dark)

All four are defined in the app source under GitComet/crates/gitcomet-ui-gpui/assets/themes/ and compiled into the binary.

Where Theme Files Live

GitComet loads theme definitions from your per-user themes directory:

This is also where you place your custom theme .json files.

Platform	Themes directory
Linux	`$XDG_DATA_HOME/gitcomet/themes` or `~/.local/share/gitcomet/themes`
macOS	`~/Library/Application Support/gitcomet/themes`
Windows	`%LOCALAPPDATA%\\gitcomet\\themes` or `%APPDATA%\\gitcomet\\themes`

Built-in themes are not written here — they live inside the binary — so this directory contains only the themes you add. GitComet also ignores any file whose name matches a bundled theme, such as gitcomet.json.

For the supported JSON format and field list, see Custom Themes. Theme files must declare "schema_version": 2; a file without it is skipped.