paseo-gruvbox

Gruvbox Dark & Light themes for Paseo — the "retro groove" color scheme, right in Settings → Appearance.

Requires Paseo >= 0.8.0 (daemon and app).

Install

paseo plugin add juanlatorre/paseo-gruvbox --ref main

Tracking main means paseo plugin update gruvbox pulls new versions. Pin a tag instead with --ref v1.0.0 if you prefer stability.

Activate

Open Settings → Appearance in any Paseo client (desktop, web, iOS, Android) and pick:

• Gruvbox Dark — bg0 #282828 with fg1 #ebdbb2 text and the signature bright yellow #fabd2f accent
• Gruvbox Light — bg0 #fbf1c7 with fg1 #3c3836 text and a faded yellow #b57614 accent for contrast on cream

Paseo derives the full token set from appearance, so surfaces, status colors, diffs, syntax, terminal, and shadows all stay coherent.

Palette mapping

Only the 8 seed colors are contributed; Paseo expands them into its full token set.

Uninstall

Themes are opt-in data, so uninstalling is always safe:

1. Pick another theme under Settings → Appearance (if a Gruvbox theme is active and the plugin goes away, Paseo falls back to the default theme automatically).
2. paseo plugin disable gruvbox to keep it installed but inactive, or paseo plugin remove gruvbox to uninstall completely.

Development

git clone https://github.com/juanlatorre/paseo-gruvbox
cd paseo-gruvbox
npm install
npm run typecheck
paseo plugin install "$PWD"
# after edits:
paseo plugin reload gruvbox

The whole plugin is a single addTheme contribution in index.client.tsx — themes are client data, so there is no server entry or daemon subprocess.

Credits

• Palette by Pavel Pertov (@morhetz) — gruvbox is MIT/X11 licensed.
• Plugin code MIT — see LICENSE.

License

MIT