paseo.cafe
All plugins

gruvbox

by juanlatorre

Gruvbox Dark & Light themes for Paseo, under Settings → Appearance

v1.0.0 Requires Paseo >=0.8.0

Gallery

Background
#282828
Text
#ebdbb2
Raised
#3c3836
Control
#504945
Border
#504945
Accent
#fabd2f
Muted
#a89984
Focus
#928374
Gruvbox Darkdark
Background
#fbf1c7
Text
#3c3836
Raised
#f2e5bc
Control
#d5c4a1
Border
#d5c4a1
Accent
#b57614
Muted
#7c6f64
Focus
#a89984
Gruvbox Lightlight

Install

paseo plugin add juanlatorre/paseo-gruvbox --ref 4d7d73f89a434db23f9870ff37b8c24d6244b6eb

Git security status and fallback installation are pinned to commit 4d7d73f89a43.

From the plugin's README

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.

README

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.

Token Gruvbox Dark Gruvbox Light
background #282828 (bg0) #fbf1c7 (bg0)
foreground #ebdbb2 (fg1) #3c3836 (fg1)
raised #3c3836 (bg1) #f2e5bc (bg0 soft)
control #504945 (bg2) #d5c4a1 (bg2)
border #504945 (bg2) #d5c4a1 (bg2)
accent #fabd2f (yellow) #b57614 (faded yellow)
mutedForeground #a89984 (fg4) #7c6f64 (fg4)
ring #928374 (gray) #a89984 (bg4)

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

License

MIT

Scanned 15 Oct 2026, 12:29 UTC from juanlatorre/paseo-gruvbox.