https://github.com/catppuccin/helix
➿ Soothing pastel theme for Helix!
https://github.com/catppuccin/helix
catppuccin hacktoberfest helix helix-editor text-editor theme
Last synced: 2 months ago
JSON representation
➿ Soothing pastel theme for Helix!
- Host: GitHub
- URL: https://github.com/catppuccin/helix
- Owner: catppuccin
- License: mit
- Created: 2022-04-10T16:31:24.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-08-04T21:58:34.000Z (2 months ago)
- Last Synced: 2025-08-05T00:13:44.005Z (2 months ago)
- Topics: catppuccin, hacktoberfest, helix, helix-editor, text-editor, theme
- Homepage:
- Size: 3.41 MB
- Stars: 203
- Watchers: 6
- Forks: 18
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Catppuccin for Helix
## Previews
🌻 Latte
🪴 Frappé
🌺 Macchiato
🌿 Mocha
## Usage
1. Helix itself includes the default variant of the theme. For other variants, copy the contents of the `themes/...` folder into `$HOME/.config/helix/themes/` to overwrite.
2. Choose a palette (latte, frappe, macchiato, mocha) and add `theme = "catppuccin_(palette)"` to your config.toml
3. (Optional) modify your `$HOME/.config/helix/config.toml` to activate features:
```toml
[editor]
line-number = "relative"
cursorline = true
color-modes = true
[editor.cursor-shape]
insert = "bar"
normal = "block"
select = "underline"
[editor.indent-guides]
render = true
```
## Customizations
You can customize the themes by inheriting your preferred flavor and applying your own modifications. For example, to create a pure black theme based on `catppuccin_mocha`, create a new file in `$HOME/.config/helix/themes/` with the following content:
```toml
inherits = "catppuccin_mocha"
[palette]
base = "#000000"
mantle = "#010101"
crust = "#020202"
```
## FAQ
### The theme isn't loading or working properly
Make sure the theme is in the correct directory and the `theme` field in your `config.toml` is set correctly.
If the theme is still not working, it may be due to true color support. Make sure your terminal emulator supports true color and is configured correctly. If you are certain that your terminal emulator supports true color, then you can try overriding Helix's true color detection in your config file as follows:
```toml
[editor]
true-color = true
```
If you still can't get the theme to work, please [open an issue](https://github.com/catppuccin/helix/issues)!
## Building the themes
Catppuccin for Helix uses [Whiskers](https://github.com/catppuccin/whiskers).
Modify the themes by editing [helix.tera](./helix.tera), then run `whiskers helix.tera` (or `just build`).
## 💝 Thanks to
- [ohxxm](https://github.com/ohxxm)
Copyright © 2021-present Catppuccin Org
