zed/crates/theme_importer
Marshall Bowers 3120a9cbea
theme_importer: Fall back to inactive tab background if no active tab background set (#3598)
This PR makes it so the `theme_importer` falls back to the inactive tab
background color if the theme doesn't not an active tab background
color.

This fixes the active tab color in the Synthwave 84 theme.

Release Notes:

- N/A
2023-12-11 17:39:46 -05:00
..
src theme_importer: Fall back to inactive tab background if no active tab background set (#3598) 2023-12-11 17:39:46 -05:00
Cargo.toml Add support for theme family-specific syntax mapping overrides (#3551) 2023-12-07 23:37:49 -05:00
README.md Add a README for theme_importer 2023-11-06 16:00:57 -05:00

Zed Theme Importer


Usage

  • cargo run -p theme_importer - Import the context of assets/themes/src

Troubleshooting

As the importer generates rust files, you may need to manually do some cleanup in registry.rs and themes/mod.rs if you remove themes or delete the themes folder in the theme crate.


Required Structure

To import a theme or series of themes 3 things are required:

  • family.json: A JSON file containing the theme family metadata and list of theme variants
  • {theme_name}.json: One theme json for each theme variant
  • LICENSE: A license file for the theme family

family.json

name

The name of the theme family. Avoid special characters.

This will be used for the theme family directory name (lowercased) and the theme family name in the Zed UI.

Good:

  • Rose Pine
  • Synthwave 84
  • Monokai Solarized

Bad:

  • Rosé Pine
  • Synthwave '84
  • Monokai (Solarized)

author

The author of the theme family. This can be a name or a username.

This will be used for the theme family author in the Zed UI.

themes

A list of theme variants.

appearance can be either light or dark. This will impact which default fallback colors are used, and where the theme shows up in the Zed UI.

{theme_name}.json

Each theme added to the family must have a corresponding JSON file. This JSON file can be obtained from the VSCode extensions folder (once you have installed it.) This is usually located at ~/.vscode/extensions (on macOS).

You can use open ~/.vscode/extensions to open the folder in Finder directly.

Copy that json file into the theme family directory and tidy up the filenames as needed.

LICENSE

A LICENSE file is required to import a theme family. Failing to provide a complete text license will cause it to be skipped when the import is run.

If the theme only provices a license code (e.g. MIT, Apache 2.0, etc.) then put that code into the LICENSE file.

If no license is provided, either contact the theme creator or don't add the theme.


Complete Example:

An example family with multiple variants:

{
  "name": "Ayu",
  // When both name and username are available
  // prefer the `username (name)` format
  "author": "dempfi (Ike Ku)",
  "themes": [
    {
      "name": "Ayu Light",
      "file_name": "ayu-light.json",
      "appearance": "light"
    },
    {
      "name": "Ayu Mirage",
      "file_name": "ayu-mirage.json",
      "appearance": "dark"
    },
    {
      "name": "Ayu Dark",
      "file_name": "ayu-dark.json",
      "appearance": "dark"
    }
  ]
}

An example single variant family:

{
  "name": "Andromeda",
  "author": "Eliver Lara (EliverLara)",
  "themes": [
    {
      "name": "Andromeda",
      "file_name": "andromeda.json",
      "appearance": "dark"
    },
    {
      "name": "Andromeda Bordered",
      "file_name": "andromeda-bordered.json",
      "appearance": "dark"
    }
  ]
}