GitComet supports built-in themes and user-provided custom themes.
Themes are loaded from JSON bundle files. GitComet ships with built-in themes and copies them into your per-user themes directory.
GitComet loads custom themes from JSON bundle files in your per-user themes directory.
GitComet only loads .json files from the user themes directory:
| 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 |
Disclaimer: The theme JSON format may change as GitComet's UI is still actively being developed.
Each theme file is a bundle with a bundle name and one or more themes. The example below includes every currently supported field:
{
"name": "My Theme Pack",
"author": "Example Author", // Optional
"themes": [
{
"key": "my_theme_dark",
"name": "My Theme Dark",
"appearance": "dark",
"colors": {
"window_bg": "#10131aff",
"surface_bg": "#171b24ff",
"surface_bg_elevated": "#1d2230ff",
"active_section": "#262c3bff",
"border": "#2c3445ff",
"tooltip_bg": "#0b0e14ff", // Optional
"tooltip_text": "#f5f7fbff", // Optional
"text": "#edf1f7ff",
"text_muted": "#9ea7b8ff",
"accent": "#59b7ffff",
"hover": "#222839ff",
"active": { "hex": "#3a4560ff", "alpha": 0.85 },
"focus_ring": { "hex": "#59b7ffff", "alpha": 0.55 },
"focus_ring_bg": { "hex": "#59b7ffff", "alpha": 0.16 },
"scrollbar_thumb": { "hex": "#9ea7b8ff", "alpha": 0.30 },
"scrollbar_thumb_hover": { "hex": "#9ea7b8ff", "alpha": 0.42 },
"scrollbar_thumb_active": { "hex": "#9ea7b8ff", "alpha": 0.52 },
"danger": "#f16b73ff",
"warning": "#ffc06aff",
"success": "#9edb63ff",
"diff_add_bg": "#163322ff", // Optional
"diff_add_text": "#b9f2c0ff", // Optional
"diff_remove_bg": "#40171dff", // Optional
"diff_remove_text": "#ffc4ccff", // Optional
"input_placeholder": "#ffffff59", // Optional
"accent_text": "#08111cff", // Optional
"emphasis_text": "#f5f7fbff", // Optional
"graph_lane_palette": [ // Optional
"#ff6b6bff",
"#ffd166ff",
"#06d6a0ff",
"#4dabf7ff"
],
"graph_lane_hues": [ // Optional
0.00,
0.18,
0.42,
0.63
]
},
"syntax": { // Optional
"comment": "#7f8aa1ff", // Optional
"comment_doc": "#91a0b8ff", // Optional
"keyword": "#7ec5ffff", // Optional
"keyword_control": "#8fd8ffff", // Optional
"number": "#9edb63ff", // Optional
"boolean": "#b4e07aff", // Optional
"function": "#78c4ffff", // Optional
"function_method": "#87d0ffff", // Optional
"function_special": "#96dbffff", // Optional
"type": "#ffc06aff", // Optional
"type_builtin": "#ffce87ff", // Optional
"type_interface": "#ffd9a3ff", // Optional
"variable": "#f3f6fbff", // Optional
"variable_parameter": "#c7d0deff", // Optional
"variable_special": "#70c5ffff", // Optional
"property": "#66c2ffff", // Optional
"constant": "#9edb63ff", // Optional
"operator": "#c5ceddff", // Optional
"punctuation": "#b4beceff", // Optional
"punctuation_bracket": "#c2cadaff", // Optional
"punctuation_delimiter": "#a9b4c7ff", // Optional
"string": "#ffd27aff", // Optional
"string_escape": "#8ce3b4ff", // Optional
"tag": "#ffc06aff", // Optional
"attribute": "#74caffff", // Optional
"lifetime": "#80d2ffff" // Optional
},
"radii": {
"panel": 2.0,
"pill": 2.0,
"row": 2.0
}
}
]
}In normal use, provide either graph_lane_palette or graph_lane_hues. The example shows both only so every supported field is visible in one place.
One file can define multiple themes. Theme keys must be unique within the file.
Each entry in themes must include:
| Field | Type | Notes |
|---|---|---|
key |
string | Stable internal identifier used in settings and persistence |
name |
string | User-facing label shown in the UI |
appearance |
string | Must be light or dark |
colors |
object | Theme color definitions |
radii |
object | Radius values for UI surfaces |
The bundle root supports:
| Field | Type | Notes |
|---|---|---|
name |
string | Required. Bundle name |
author |
string | Optional |
themes |
array | Required. One or more theme entries |
window_bg, surface_bg, surface_bg_elevated, active_section, border, text, text_muted, accent, hover, active, focus_ring, focus_ring_bg, scrollbar_thumb, scrollbar_thumb_hover, scrollbar_thumb_active, danger, warning, success
tooltip_bg, tooltip_text, diff_add_bg, diff_add_text, diff_remove_bg, diff_remove_text, input_placeholder, accent_text, emphasis_text, graph_lane_palette, graph_lane_hues
Most color fields accept either:
- a hex RGBA string such as
#0d1016ff - an object with
hexplusalpha, for example{ "hex": "#5ac1feff", "alpha": 0.60 }
Use graph_lane_palette for an explicit list of colors, or graph_lane_hues for a list of hue values that GitComet turns into graph lane colors automatically.
If you omit optional diff colors, tooltip colors, placeholder color, accent text color, emphasis text color, or syntax colors, GitComet falls back to built-in defaults.
More generally, omitted optional values are either derived from the theme's base colors or filled with built-in defaults, depending on the field.
The syntax object is optional. Supported keys are:
comment, comment_doc, string, string_escape, keyword, keyword_control, number, boolean, function, function_method, function_special, type, type_builtin, type_interface, variable, variable_parameter, variable_special, property, constant, operator, punctuation, punctuation_bracket, punctuation_delimiter, tag, attribute, lifetime
Use type in JSON for the main type-name color.
The radii object is required and must include:
panelpillrow
These values are numeric and control the corner radius used by major UI elements.
- GitComet loads every
.jsonfile in the themes directory. - A runtime theme can override a bundled theme by reusing the same
key. - A file that cannot be read or parsed is ignored.
- GitComet does not expose a separate machine-readable JSON Schema file today; the implementation in
crates/gitcomet-ui-gpui/src/theme.rsis the source of truth.