Skip to content

Latest commit

 

History

History
58 lines (39 loc) · 3.13 KB

README.md

File metadata and controls

58 lines (39 loc) · 3.13 KB

header

Helix Themes

A few themes for the helix editor. Most of them are direct ports of existing themes.

The included themes generally follow these rules:

  • Medium contrast and saturation
  • Balanced use of different colors (easily discernable syntax)
  • Not too many colors

For preview images see: PREVIEWS.md

Included themes

Download

The latest build of the main branch can be downloaded from the GitHub releases page here.

The release date and commit on the releases page point to an old version. However, build.tar.gz is always up to date.

Installation

User themes can be added to the themes subdirectory of the config location (for example ~/.config/helix/themes on Linux, or C:/Users/<user>/AppData/Roaming/helix/themes on Windows). To "install" a theme simply copy it into that directory (you may have to create it if it doesn't exist yet). Alternatively you can symlink the whole themes directory.

If you are unsure where the config path is located on your machine, run hx --health and look for Config file: ... at the top. You can read more about themes in the Helix docs here.

Building manually

Themes are split into a color scheme or "mapping" ("constants are purple") and one or more palettes ("purple is #b39df3"). Each theme is built by simply merging the scheme with one of the corresponding palettes.

You can generate all themes by running build.sh from the root of the repository.

Or just generate a single one:

cat "schemes/gruvbox" "palettes/gruvbox/material_dark_medium" > "theme.toml"

On Windows you can run the shell script (or cat command above) from the git bash that comes with git or use the executable directly (<git path>/usr/bin/sh.exe build.sh).