v0.1.0 · MIT · heartbox.f00.sh

Heartbox

A dark theme that feels hand-tinted — poppy red over night soil, verse-sky blue, chorus heat, anatomical pink, bruise purple, and a cool silver metal accent. One palette. Ports for terminals, editors, shells, bars, and tools.

get the theme see the colors

Palette

canonical tokens

Silver is intentional and subtle — cursor, chrome, punctuation — the cool metal of a worn jacket against warm black.

Feel

warm hospital-night blacks, never pure navy
hyper-real poppy red as hero accent
verse calm (sky) vs chorus heat (red)
cream foreground — not pure white
dusty mauve comments, soft focus
silver metal for edges and cursor only

Ports

Built-in ports ship in-repo under themes/. More apps welcome — follow themes/TEMPLATE.md.

Install

# clone

git clone https://github.com/f00-sh/heartbox.git
cd heartbox

# pick a port

ls themes/
# e.g. kitty:
cp themes/kitty/heartbox.conf ~/.config/kitty/themes/
# include or load per app README / themes/TEMPLATE.md

# regenerate ports from palette (maintainers)

python3 scripts/generate-themes.py

Canonical source of truth: palette/heartbox.json (+ CSS / TOML / YAML / SCSS).

Documents

README
man page
CHANGELOG
docs/
SOP PDF & release memo — attached on GitHub Releases