README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

# yo-theme-helix

A [Helix][helix] theme inspired by [Zenbones][zenbones] & [Alabaster][alabaster]. Uses [radix colors][radix].

## Notes

- Ideas from alabaster.
  - Comments should stand out.
  - Use color sparingly. The rules should be simple.
- Alabaster essentially skips eveything else it doesn't highlight keywords (reserved words) or types. 
  (which to be fair isn't really an issue for clojure)
  - Yo doesn't go quite as far on this point. 
  - Instead it takes the minimal approach used by zenbones to highlight the remaining code constructs.
    - subtle colors, contrast & font variants
    - vibrant colors are left for diagnostics.
- The default yo themes use the following:
  - **Green: for strings (same as alabaster)**
  - **Purple: for constant (same as alabaster)**
  - **Blue: for comments (incl. LSP info/hints)**
  - **Red/Amber: LSP error/warnings**
  - **Gray/Bronze: Everything else zenbones style**
- I'm not a designer and don't like my chances of making something look good by tweaking colors so instead
i'll let the pros handle it.
  - [Radix Colors][radix] are very well deisgned. with clear instructions for how to apply them.
  - Designed for **automatic light/dark mode**.
- Variants. 
  - It should be straightforward to use helix theme inheritance to swap out the default color palette
with other radix color combinations without losing the design principles of the theme.


[helix]: https://helix-editor.com/
[zenbones]: https://github.com/mcchrish/zenbones.nvim
[alabaster]: https://github.com/tonsky/vscode-theme-alabaster
[radix]: https://www.radix-ui.com/colors