Files
oak-gpui/docs/src/themes.md
T
+4 eb3c4b0e46 Docs Party 2024 (#15876)
Co-authored-by: Raunak Raj <nkray21111983@gmail.com>
Co-authored-by: Thorsten Ball <mrnugget@gmail.com>
Co-authored-by: Bennet <bennet@zed.dev>
Co-authored-by: Marshall Bowers <elliott.codes@gmail.com>
Co-authored-by: Joseph T Lyons <JosephTLyons@gmail.com>
Co-authored-by: Mikayla <mikayla@zed.dev>
Co-authored-by: Jason <jason@zed.dev>
Co-authored-by: Antonio Scandurra <me@as-cii.com>
Co-authored-by: Max Brunsfeld <maxbrunsfeld@gmail.com>
Co-authored-by: Marshall <marshall@zed.dev>
Co-authored-by: Nathan Sobo <nathan@zed.dev>
Co-authored-by: Jason Mancuso <7891333+jvmncs@users.noreply.github.com>
Co-authored-by: Piotr Osiewicz <24362066+osiewicz@users.noreply.github.com>
2024-08-09 13:37:54 -04:00

63 lines
2.4 KiB
Markdown

# Themes
Zed comes with a number of built-in themes, with more themes available as extensions.
## Selecting a Theme
You can see what these are installed and preview them from the Theme Selector. You can open the Theme Selector from the command palette with "theme selector: Toggle" (bound to `cmd-k cmd-t` on macOS and `ctrl-k ctrl-t` on Linux). Selecting a theme by moving up and down will change the theme in real time and hitting enter will save it to your settings file.
## Installing more Themes
More themes are available from the Extensions page. You can open the Extensions page from the command palette with "zed: Extensions". Many popular themes have been ported to Zed, and if you're struggling to choose one, there's a third-party gallery hosted by https://zed-themes.com with visible previews for many of them.
## Configuring a Theme
Your 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).
By 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.
```json
{
"theme": {
"mode": "system",
"light": "One Light",
"dark": "One Dark"
}
}
```
## Theme Overrides
You can also override specific attributes of a theme, by using the `experimental.theme_overrides` setting.
For example, to override the background color of the editor and the font style of comments, you can add the following to your `settings.json` file:
```json
{
"experimental.theme_overrides": {
"editor.background": "#333",
"syntax": {
"comment": {
"font_style": "italic"
}
}
}
}
```
You can see 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).
## Local Themes
You can store new themes locally, by placing them in the `~/.config/zed/themes` directory.
For example, to create a new theme called `my-cool-theme`, you can create a file called `my-cool-theme.json` in that directory.
It will be available in the theme selector the next time Zed loads.
You can find a lot of themes at [zed-themes.com](https://zed-themes.com).
## Theme Development
See: [Developing Zed Themes](./extensions/themes.md)