Gruvbox — Retro Groove Color Scheme for Code Editors

Introduction

Gruvbox is a Vim color scheme created by Pavel Pertsev (morhetz) that draws inspiration from retro computing aesthetics. Its warm palette of browns, muted oranges, and soft yellows creates a distinctive look that is easy on the eyes during long coding sessions. Since its release, Gruvbox has been ported to virtually every code editor, terminal, and developer tool.

What Gruvbox Does

• Provides a warm dark and light color scheme with carefully balanced contrast
• Offers three contrast variants (soft, medium, hard) for both dark and light modes
• Defines a consistent palette of 8 accent colors plus neutral tones
• Includes specific highlight groups for popular Vim plugins and language syntaxes
• Serves as the base palette for community ports across terminals, IDEs, and desktop environments

Architecture Overview

Gruvbox is implemented as a Vim colorscheme script that sets highlight groups based on the detected background mode and contrast setting. The palette defines exact hex and 256-color terminal values for each color. The original Vimscript version maps syntax groups for dozens of file types and plugins. Community ports like gruvbox.nvim (Lua), gruvbox-material, and gruvbox-flat extend the palette to Neovim's Treesitter highlight groups and LSP diagnostics.

Self-Hosting & Configuration

• Install the gruvbox plugin via your Vim or Neovim plugin manager
• Set background=dark or background=light and then colorscheme gruvbox
• Adjust contrast with let g:gruvbox_contrast_dark = 'hard' (options: soft, medium, hard)
• For terminals, import the Gruvbox palette from the relevant port repository
• For VS Code, install the jdinhlife.gruvbox extension and pick your preferred variant

Key Features

• Warm retro palette that reduces eye fatigue compared to cooler themes
• Six modes: dark and light each with soft, medium, and hard contrast
• Extensive Vim syntax group coverage including Treesitter support in Lua variants
• One of the most widely ported color schemes with hundreds of community ports
• Stable palette that has not changed since original publication

Comparison with Similar Tools

• Solarized — Scientifically derived cool tones; Gruvbox is warmer and more visually distinct
• Catppuccin — Modern pastel tones with four flavors; Gruvbox has a retro aesthetic with three contrasts
• Dracula — Cool purples and pinks; Gruvbox uses earthy oranges and yellows
• Nord — Arctic blue palette; Gruvbox sits at the opposite end of the temperature spectrum
• Gruvbox Material — A refined fork that smooths some rough edges while keeping the Gruvbox palette

FAQ

Q: What is the difference between gruvbox and gruvbox-material? A: Gruvbox Material by sainnhe softens some of the original's harsher contrasts and adds Treesitter and LSP diagnostic highlights. The core palette remains similar.

Q: Can I use Gruvbox with Treesitter in Neovim? A: The original Vimscript version has limited Treesitter support. Use ellisonleao/gruvbox.nvim or sainnhe/gruvbox-material for full Treesitter highlight groups.

Q: Does Gruvbox support both 256-color and true color terminals? A: Yes. The colorscheme includes both 256-color approximations and exact hex values for true color terminals. Set termguicolors in Neovim for best results.

Q: Is Gruvbox free to use? A: Yes. The original Vim colorscheme is released under the MIT/X11 License.

Sources

• https://github.com/morhetz/gruvbox
• https://github.com/ellisonleao/gruvbox.nvim