docs updates

This commit is contained in:
Raven Scott
2026-04-04 08:31:39 -04:00
parent 0e53351349
commit 081e4c587c
64 changed files with 2052 additions and 1273 deletions
+23 -9
View File
@@ -6,21 +6,35 @@ They are **authored in-repo** for consistency with [`bare-os-theme-presets.js`](
Naming follows common patterns (similar in spirit to catalogs like [terminalcolors.com](https://terminalcolors.com/)): `alacritty-<preset>.yml`, `warp-<preset>.yaml`, `iterm-<preset>.itermcolors`.
| File | Preset | Format | Import |
|------|--------|--------|--------|
| `alacritty-nord.yml` | `nord` | [Alacritty](https://github.com/alacritty/alacritty) YAML | Merge `colors:` into `alacritty.yml` |
| `alacritty-dracula.yml` | `dracula` | Alacritty YAML | Same |
| `warp-nord.yaml` | `nord` | [Warp](https://docs.warp.dev/appearance/custom-themes) | Theme picker / path |
| `warp-dracula.yaml` | `dracula` | Warp | Same |
| `iterm-nord.itermcolors` | `nord` | iTerm2 / Terminal.app | **Profiles → Colors → Color Presets → Import** |
| `iterm-dracula.itermcolors` | `dracula` | iTerm2 / Terminal.app | Same |
---
Additional presets (`gruvbox_dark`, `tokyo_night`, `catppuccin_mocha`, …) can be added here using the same filenames; contributions should keep parity with the JS preset names.
## On this page
- [Bundled theme files](#bundled-theme-files)
- [Preset names](#preset-names)
- [Related session variables](#related-session-variables)
---
## Bundled theme files
- **`alacritty-nord.yml`** — Preset **`nord`**. [Alacritty](https://github.com/alacritty/alacritty) YAML. **Import:** merge the `colors:` block into your `alacritty.yml`.
- **`alacritty-dracula.yml`** — Preset **`dracula`**. Alacritty YAML. **Import:** same as above.
- **`warp-nord.yaml`** — Preset **`nord`**. [Warp](https://docs.warp.dev/appearance/custom-themes) theme. **Import:** use Warps theme picker or point it at this path.
- **`warp-dracula.yaml`** — Preset **`dracula`**. Warp. **Import:** same as above.
- **`iterm-nord.itermcolors`** — Preset **`nord`**. iTerm2 / Terminal.app. **Import:** **Profiles → Colors → Color Presets → Import**.
- **`iterm-dracula.itermcolors`** — Preset **`dracula`**. iTerm2 / Terminal.app. **Import:** same as above.
Additional presets (`gruvbox_dark`, `tokyo_night`, `catppuccin_mocha`, …) can be added here using the same filenames; contributions should keep parity with the JavaScript preset names in the booter.
---
## Preset names
Run `theme list` in a Bare OS shell. Examples: `default`, `nord`, `dracula`, `gruvbox_dark`, `catppuccin_mocha`, `tokyo_night`, `github_dark`, `solarized_dark`.
---
## Related session variables
See [environment variables reference](../reference/environment-and-posix-appendix.md#14-environment-variables-complete-list): `BARE_OS_THEME`, `BARE_OS_COLOR_DEPTH`, `LS_COLORS`, `BARE_OS_DIRCOLORS`, and host passthrough `TERM` / `COLORTERM`.