<h1 align="center"><img src="assets/logo.svg" width="840" alt="Bluney"></h1>

![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)
![Vim](https://img.shields.io/badge/vim-9%2B-blue.svg)
![Neovim](https://img.shields.io/badge/neovim-0.9%2B-blue.svg)
![Termux](https://img.shields.io/badge/termux-supported-blue.svg)
![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
![Emacs](https://img.shields.io/badge/emacs-28%2B-blue.svg)
![Fish](https://img.shields.io/badge/fish-3.0%2B-blue.svg)
![Zsh](https://img.shields.io/badge/zsh-5.0%2B-blue.svg)
![Powerlevel10k](https://img.shields.io/badge/powerlevel10k-supported-blue.svg)
![Yazi](https://img.shields.io/badge/yazi-supported-blue.svg)
![Helix](https://img.shields.io/badge/helix-supported-blue.svg)
![Lazygit](https://img.shields.io/badge/lazygit-supported-blue.svg)
![Nano](https://img.shields.io/badge/nano-supported-blue.svg)
![Zellij](https://img.shields.io/badge/zellij-supported-blue.svg)
![Vivid](https://img.shields.io/badge/vivid-supported-blue.svg)
![Foot](https://img.shields.io/badge/foot-supported-blue.svg)
![micro](https://img.shields.io/badge/micro-supported-blue.svg)

**Blue-injected terminal, editor, shell and app theme family.** Like oceanic but slightly bluer — every neutral hue-shifted toward blue, every accent a blue derivative.

**Generated theme family.** Every artifact is rendered from a single `palette.json` by `gen.py` (stdlib only). Run `make gen` to regenerate, `make check` to verify no drift.

**[Open the theme gallery →](https://mark44928.github.io/Bluney/gallery.html)** — dark/light swatches, terminal preview and every supported app in one offline page.

Handy generator commands:

```bash
make gen-only APP=vim   # regenerate only artifacts whose path contains "vim"
make list-artifacts     # print every generated path (for dotfile scripts)
```

Two variants: **Dark** (`bluney`) and **Light** (`bluney-light`).

## Preview

![Bluney palette preview — Dark and Light variants](assets/palette-preview.svg)

![Bluney dark/light swatch — generated from palette.json](docs/palette.png)

Dark (left panel) and light (right panel) render side by side in both images: `palette-preview.svg` is generated by `make preview` (stdlib-only, `scripts/svgswatch.py`), `palette.png` by `scripts/swatch.py`. Both read `palette.json`, so the docs cannot drift from the palette.

WCAG AA: dark fg/bg = 13.43:1, light fg/bg = 12.38:1 (regenerated by `make contrast`; see [palette.md](palette.md)).

## How it works

| File | Purpose |
|------|---------|
| `palette.json` | Single source of truth — all color values, both variants |
| `gen.py` | Stdlib-only renderer; reads `palette.json`, renders every artifact |
| `templates/*.tmpl` | One template per app format |
| `Makefile` | `make gen` renders all artifacts; `make check` regenerates + regenerates the WCAG contrast table + `git diff --exit-code` + the Vim colorscheme load test |

**Byte-identical proof:** `make check` leaves `git diff` empty — generated output matches the committed files exactly, proving the templates faithfully reproduce the theme family. The WCAG contrast table in `palette.md` is generated by `make contrast` (`tests/contrast.py`), so changing a color in `palette.json` can never leave a stale documented ratio behind.

## Quick Install

### One-command installer

The installer detects supported apps, backs up any existing theme files, and
copies the matching variant. It never edits your main app configs — it prints
the one include/theme line to add instead.

```bash
./install.sh                     # interactive, dark by default
./install.sh --light --all       # light variant, every detected app
./install.sh --only termux,kitty,vim
./install.sh --list              # show detected targets
./install.sh --all --dry-run     # preview copies
./install.sh --uninstall         # remove files recorded by the installer
```

Replaced files are backed up; the installer records what it wrote in
`$XDG_STATE_HOME/<theme>/installed.tsv` so uninstall never deletes a file you
edited (use `--force` to override).

### Neovim

**lazy.nvim** — this is the whole setup:

```lua
{
  "Mark44928/Bluney",
  lazy = false,
  priority = 1000,
  opts = {},
  config = function(_, opts) require("bluney").setup(opts) end,
}
```

For the light variant set `opts = { variant = "light" }`.

**vim.pack** (Neovim 0.12+):

```lua
vim.pack.add({ "https://github.com/Mark44928/Bluney" })
require("bluney").setup()
```

**Vim (manual runtime):**

```bash
git clone https://github.com/Mark44928/Bluney.git
cp Bluney/colors/bluney.vim ~/.vim/colors/
cp Bluney/colors/bluney-light.vim ~/.vim/colors/
```

```vim
set termguicolors
colorscheme bluney
```

**Screenshots:** [dark](docs/neovim-dark.png) · [light](docs/neovim-light.png)

| Neovim dark | Neovim light |
|---|---|
| ![Bluney in Neovim dark](docs/neovim-dark.png) | ![Bluney in Neovim light](docs/neovim-light.png) |

### Terminal emulators
**Kitty**
```bash
cp extras/kitty.conf ~/.config/kitty/bluney.conf
# add to kitty.conf:  include bluney.conf
# light variant:      cp extras/kitty-light.conf ~/.config/kitty/bluney-light.conf
```

**Alacritty**
```bash
mkdir -p ~/.config/alacritty/themes
cp extras/alacritty.toml ~/.config/alacritty/themes/bluney.toml
# add to alacritty.toml:  import = ["~/.config/alacritty/themes/bluney.toml"]
```

**Ghostty**
```bash
cp extras/ghostty ~/.config/ghostty/bluney
# add to config:  include = ~/.config/ghostty/bluney
# light variant:  cp extras/ghostty-light ~/.config/ghostty/bluney-light
```

**WezTerm**
```bash
cp extras/wezterm.lua ~/.config/wezterm/bluney.lua
# in ~/.wezterm.lua:  require("bluney")
```

**iTerm2**
Open iTerm2 → Preferences → Profiles → Colors → Color Presets → Import → select `extras/bluney.itermcolors` (or `extras/bluney-light.itermcolors` for the light variant).

**Windows Terminal**
Import `extras/windows-terminal.json` via **Settings → Color schemes → Import**.

**Termux**
```bash
cp termux/bluney-dark.properties ~/.termux/colors.properties && termux-reload-settings
# light variant:
cp termux/bluney-light.properties ~/.termux/colors.properties && termux-reload-settings
```

### Shell & prompt

**Emacs** (`bluney-dark-theme.el` / `bluney-light-theme.el`)
```elisp
;; ~/.emacs.d/init.el or ~/.emacs
(add-to-list 'custom-theme-load-path "$HOME/Bluney/emacs")
(load-theme 'bluney-dark t)   ;; or 'bluney-light
```

**Fish shell** (`bluney-dark.theme` / `bluney-light.theme`)
```fish
# Install via fish_config → select "Bluney dark" / "Bluney light"
# Or set manually:
cp fish/bluney-dark.theme ~/.config/fish/themes/
fish_config
```

**Powerlevel10k** (`bluney-dark.zsh` / `bluney-light.zsh`)
```zsh
source "$HOME/Bluney/powerlevel10k/bluney-dark.zsh"
# or: source "$HOME/Bluney/powerlevel10k/bluney-light.zsh"
```

**git** (`bluney-dark.config` / `bluney-light.config`)
```ini
# ~/.gitconfig
[include]
    path = "$HOME/Bluney/git/bluney-dark.config"
```

**git-delta** (`bluney-dark.config` / `bluney-light.config`)
```ini
# ~/.gitconfig
[include]
    path = "$HOME/Bluney/delta/bluney-dark.config"
[delta]
    features = bluney-dark   # or bluney-light
```

**lsd** (`bluney-dark.colors.yaml` / `bluney-light.colors.yaml`)
```yaml
# ~/.config/lsd/config.yaml
color:
  theme: custom
```
```bash
cp lsd/bluney-dark.colors.yaml ~/.config/lsd/colors.yaml
```

**exa** (`bluney-dark.colors` / `bluney-light.colors`)
```bash
export EXA_COLORS="$(cat exa/bluney-dark.colors)"
```

**ripgrep** (`bluney-dark.rc` / `bluney-light.rc`)
```bash
export RIPGREP_CONFIG_PATH="$HOME/Bluney/ripgrep/bluney-dark.rc"
```

**less** (`bluney-dark.termcap` / `bluney-light.termcap`)
```bash
. "$HOME/Bluney/less/bluney-dark.termcap"
```

**fastfetch** (`bluney-dark.jsonc` / `bluney-light.jsonc`)
```bash
cp fastfetch/bluney-dark.jsonc ~/.config/fastfetch/config.jsonc
# light variant:
cp fastfetch/bluney-light.jsonc ~/.config/fastfetch/config.jsonc
# or load directly:
fastfetch -c fastfetch/bluney-dark.jsonc
```

**yazi** (`bluney-dark.toml` / `bluney-light.toml`)
```bash
cp yazi/bluney-dark.toml ~/.config/yazi/theme.toml
# light variant:
cp yazi/bluney-light.toml ~/.config/yazi/theme.toml
```

**helix** (`bluney-dark.toml` / `bluney-light.toml`)
```bash
cp helix/bluney-dark.toml ~/.config/helix/themes/bluney-dark.toml
# light variant:
cp helix/bluney-light.toml ~/.config/helix/themes/bluney-light.toml
# then in ~/.config/helix/config.toml:  theme = "bluney-dark"
```

**lazygit** (`bluney-dark.yml` / `bluney-light.yml`)
```bash
cp lazygit/bluney-dark.yml ~/.config/lazygit/bluney-dark.yml
# light variant:
cp lazygit/bluney-light.yml ~/.config/lazygit/bluney-light.yml
# then: lazygit --use-config-file ~/.config/lazygit/config.yml,~/.config/lazygit/bluney-dark.yml
```

**nano** (`bluney-dark.nanorc` / `bluney-light.nanorc`)
```bash
cp nano/bluney-dark.nanorc ~/.config/nano/nanorc
# light variant:
cp nano/bluney-light.nanorc ~/.config/nano/nanorc
# or add to ~/.nanorc:  include ~/.config/nano/nanorc
```

**zellij** (`bluney-dark.kdl` / `bluney-light.kdl`)
```bash
mkdir -p ~/.config/zellij/themes
cp zellij/bluney-dark.kdl ~/.config/zellij/themes/
# light variant:
cp zellij/bluney-light.kdl ~/.config/zellij/themes/
# then in ~/.config/zellij/config.kdl:  theme "bluney-dark"
```

**vivid** (`bluney-dark.yml` / `bluney-light.yml`) — new in 1.1.0
```bash
# print the LS_COLORS theme for the current shell
vivid generate vivid/bluney-dark.yml
# or apply it for the session:
eval "$(vivid generate vivid/bluney-dark.yml)"
# preview a directory without changing anything:
vivid apply vivid/bluney-dark.yml -V
```

**foot** (`bluney-dark.ini` / `bluney-light.ini`) — new in 1.1.0
```bash
cp foot/bluney-dark.ini ~/.config/foot/foot.ini
# light variant, or keep both and include one:
#   include=~/.config/foot/bluney-light.ini
```

### Syntax highlighting & tools

**bat** (`bluney-dark.tmTheme` / `bluney-light.tmTheme`)
```bash
mkdir -p "$(bat --config-dir)/themes"
cp bat/bluney-dark.tmTheme "$(bat --config-dir)/themes/"
bat cache --build
bat --theme Bluney-dark file.rs
# light: bat --theme Bluney-light
```

**fzf** (`bluney-dark.sh` / `bluney-light.sh`)
```bash
. "$HOME/Bluney/fzf/bluney-dark.sh"
# or add to ~/.zshrc / ~/.bashrc
```

**dircolors** (`bluney-dark` / `bluney-light`)
```bash
eval "$(dircolors -b dircolors/bluney-dark)"
# light: eval "$(dircolors -b dircolors/bluney-light)"
```

**starship** (`bluney-dark.toml` / `bluney-light.toml`)
```bash
cp starship/bluney-dark.toml ~/.config/starship.toml
# light: cp starship/bluney-light.toml ~/.config/starship.toml
```

**tmux** (`bluney-dark.conf` / `bluney-light.conf`)
```bash
tmux source-file "$HOME/Bluney/tmux/bluney-dark.conf"
# light: tmux source-file "$HOME/Bluney/tmux/bluney-light.conf"
```

**btop** (`bluney-dark.theme` / `bluney-light.theme`)
```bash
cp btop/bluney-dark.theme ~/.config/btop/themes/
# set color_theme = "bluney-dark" in btop.conf
```

**micro** (`bluney-dark.micro` / `bluney-light.micro`)
```bash
mkdir -p ~/.config/micro/colorschemes
cp micro/bluney-dark.micro ~/.config/micro/colorschemes/
# in micro: set colorscheme bluney-dark
# light: cp micro/bluney-light.micro ~/.config/micro/colorschemes/
```

## Verify the Colorscheme

```bash
# Dark variant — Normal must show guifg/#C9E4CE guibg/#0C1F17, name prints 'bluney'
vim -u NONE -N -c "set t_Co=256 rtp+=$HOME/Bluney" \
    -c "colorscheme bluney" -c "hi Normal" -c "echo g:colors_name" -c "qa!"

# Light variant — Normal must show guifg/#24382C guibg/#F2F7EF, name prints 'bluney-light'
vim -u NONE -N -c "set t_Co=256 rtp+=$HOME/Bluney" \
    -c "colorscheme bluney-light" -c "hi Normal" -c "echo g:colors_name" -c "qa!"
```

## Generator workflow

```bash
make gen       # render every artifact from palette.json
make check     # regenerate, regenerate the WCAG table, fail on git diff (drift detection), load the scheme in Vim
```

## Palette

| Role | Dark | Light |
|------|------|-------|
| bg | `#0C1F17` | `#F2F7EF` |
| surface | `#122A1F` | `#E6EFE2` |
| fg | `#C9E4CE` | `#24382C` |
| comment | `#78997F` | `#56695C` |
| primary | `#7BD88F` | `#7BD88F` |
| secondary | `#63C9A8` | `#63C9A8` |
| yellow | `#B8CC7A` | `#B8CC7A` |
| rose | `#A88EA0` | `#A88EA0` |
| cyan | `#7FD7C4` | `#7FD7C4` |
| error | `#C07A6E` | `#C07A6E` |

## ANSI 16-Color Table

Bright colors (8–15) are visibly lighter variants of their normal counterparts (1–7), per the recipe. No duplicates.

| Var | Dark | Light |
|-----|------|-------|
| color0 | `#1A331C` | `#E6EFE2` |
| color1 | `#A88EA0` | `#C07A6E` |
| color2 | `#7BD88F` | `#7BD88F` |
| color3 | `#B8CC7A` | `#B8CC7A` |
| color4 | `#63C9A8` | `#63C9A8` |
| color5 | `#A88EA0` | `#A88EA0` |
| color6 | `#7FD7C4` | `#7FD7C4` |
| color7 | `#A7C4A3` | `#C9E4CE` |
| color8 | `#78997F` | `#56695C` |
| color9 | `#D4B4C0` | `#E49A8E` |
| color10 | `#9BEDAF` | `#9BEDAF` |
| color11 | `#D4E49A` | `#D4E49A` |
| color12 | `#8FE4C4` | `#8FE4C4` |
| color13 | `#D4B4C0` | `#D4B4C0` |
| color14 | `#A7EBDC` | `#A7EBDC` |
| color15 | `#C9E4CE` | `#FFFFFF` |

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for adding terminal emulators, changing the palette, and submitting PRs.

**The generator rule:** change a color only in `palette.json`, then `make gen && make contrast` — `gen.py` propagates to every generated artifact (`colors/`, `termux/`, `extras/`, `templates/` outputs). Only `README.md`, `palette.md` prose, and `assets/palette-preview.svg` (`make preview`) are maintained by hand and updated in the same commit.


## 🛠️ More from Mark44928

Tiny, dependency-free tools from the same family:

- [Pythonator](https://github.com/Mark44928/Pythonator) — Python rewrite of Plusalator — stdlib-only, `--eval`/`--json`
- [Greenit](https://github.com/Mark44928/Greenit) — green-injected theme family — dark + light, single palette.json
- [Mark44928](https://github.com/Mark44928) — profile and project index
- [plusafetch](https://github.com/Mark44928/plusafetch) — C++23 fetch for Termux — ~23 ms, zero subprocesses on the default path
- [Plusalator](https://github.com/Mark44928/Plusalator) — C++17 calculator REPL — Qalculate-flavored, ghost autosuggest, 18 themes
- [GrubBlastersHTML](https://github.com/Mark44928/GrubBlastersHTML) — Turn-based artillery in one HTML file — 72 weapons, fully destructible terrain
- [SnakTUI](https://github.com/Mark44928/SnakTUI) — Snake game for the terminal — Textual + Python
- [Easy-Termux-Package-Manager](https://github.com/Mark44928/Easy-Termux-Package-Manager) — fzf-driven package manager for Termux — snapshots, audit, 194 tests
- [NoNameOS](https://github.com/Mark44928/NoNameOS) — OS simulation in a single C++17 file — virtual FS, real shell
- [CalculaHTML](https://github.com/Mark44928/CalculaHTML) — static HTML calculator — 15 themes + System mode, zero deps
- [android12-fastfetch](https://github.com/Mark44928/android12-fastfetch) — fastfetch config for Android 12 + native X11 Termux desktops
- [Anti-bloatware-list-for-Android-TV-Boxes-and-Sticks-for-rooted](https://github.com/Mark44928/Anti-bloatware-list-for-Android-TV-Boxes-and-Sticks-for-rooted) — ADB debloat for rooted Android 9+ TV sticks & boxes
- [Android9-audios](https://github.com/Mark44928/Android9-audios) — 217 stock Android 9 system sounds + per-file SHA-256

## License

[MIT](LICENSE)
