themes.md

 1# Themes
 2
 3Zed comes with a number of built-in themes, with more themes available as extensions.
 4
 5## Selecting a Theme
 6
 7See what themes are installed and preview them via the Theme Selector, which you can open from the command palette with "theme selector: Toggle" (bound to `cmd-k cmd-t` on macOS and `ctrl-k ctrl-t` on Linux).
 8
 9Navigating through the theme list by moving up and down will change the theme in real time and hitting enter will save it to your settings file.
10
11## Installing more Themes
12
13More themes are available from the Extensions page, which you can access via the command palette with "zed: Extensions" or the [Zed website](https://zed.dev/extensions).
14
15Many popular themes have been ported to Zed, and if you're struggling to choose one, visit [zed-themes.com](https://zed-themes.com), a third-party gallery with visible previews for many of them.
16
17## Configuring a Theme
18
19Your selected theme is stored in your settings file. You can open your settings file from the command palette with "zed: Open Settings" (bound to `cmd-,` on macOS and `ctrl-,` on Linux).
20
21By default, Zed maintains two themes: one for light mode and one for dark mode. You can set the mode to `"dark"` or `"light"` to ignore the current system mode.
22
23```json
24{
25  "theme": {
26    "mode": "system",
27    "light": "One Light",
28    "dark": "One Dark"
29  }
30}
31```
32
33## Theme Overrides
34
35To override specific attributes of a theme, use the `experimental.theme_overrides` setting.
36
37For example, to override the background color of the editor and the font style of comments, add the following to your `settings.json` file:
38
39```json
40{
41  "experimental.theme_overrides": {
42    "editor.background": "#333",
43    "syntax": {
44      "comment": {
45        "font_style": "italic"
46      }
47    }
48  }
49}
50```
51
52See which attributes are available to override by looking at the JSON format of your theme. For example, [here is the JSON format for the `One` themes](https://github.com/zed-industries/zed/blob/main/assets/themes/one/one.json).
53
54## Local Themes
55
56Store new themes locally by placing them in the `~/.config/zed/themes` directory.
57
58For example, to create a new theme called `my-cool-theme`, create a file called `my-cool-theme.json` in that directory. It will be available in the theme selector the next time Zed loads.
59
60Find more themes at [zed-themes.com](https://zed-themes.com).
61
62## Theme Development
63
64See: [Developing Zed Themes](./extensions/themes.md)