gruvbox.nvim
A Lua port of the classic gruvbox color scheme for Neovim with Tree-sitter and LSP semantic highlight support.
What is gruvbox.nvim?
gruvbox.nvim is a Lua port of the classic gruvbox color scheme for Neovim, providing a modern implementation with support for Tree-sitter and LSP semantic highlighting. It solves the need for a performant, customizable theme that integrates seamlessly with Neovim's advanced features while retaining the familiar gruvbox aesthetic.
Neovim users who prefer the gruvbox color scheme and want enhanced syntax highlighting through Tree-sitter and LSP, with extensive customization options.
Developers choose gruvbox.nvim for its native Lua performance, deep integration with Neovim's modern features like Tree-sitter and LSP, and its highly configurable design that allows precise control over colors and highlights.
Overview
Lua port of the most famous vim colorscheme
Use Cases
Best For
- Neovim users migrating from Vim's gruvbox theme
- Customizing syntax highlighting with Tree-sitter support
- Integrating LSP semantic token highlighting into a color scheme
- Creating personalized color overrides for specific highlight groups
- Using a transparent background mode in Neovim
- Switching between light and dark themes easily
Not Ideal For
- Users of standard Vim or Neovim versions below 0.8.0
- Developers wanting a plug-and-play color scheme with zero configuration
- Projects requiring cross-editor theme compatibility (e.g., for VS Code or Sublime Text)
- Teams that rely on pre-configured, opinionated themes without manual highlight overrides
Pros & Cons
Pros
Integrates Tree-sitter for accurate language parsing and LSP semantic tokens for context-aware coloring, enabling advanced features like overriding '@lsp.type.method' groups as shown in the README.
Supports palette_overrides and detailed highlight group overrides, including for Tree-sitter and LSP tokens, allowing precise color tuning without modifying the core theme.
Includes both dark and light background variants with easy switching via vim.o.background, catering to different preferences and environments.
Written in Lua for native Neovim performance and seamless setup with package managers like packer and lazy.nvim, ensuring smooth operation.
Cons
Requires Neovim 0.8.0 or higher, excluding users of standard Vim, older Neovim versions, or other editors, as stated in the prerequisites.
Advanced customization, such as overriding Tree-sitter groups, demands understanding of Neovim's highlight system and Lua setup, which can be complex for casual users.
As a port of the specific gruvbox aesthetic, it may lack built-in support for non-standard plugins or highlight groups, requiring manual overrides for full compatibility.
Frequently Asked Questions
Related Projects
tokyonight.nvim🏙 A clean, dark Neovim theme written in Lua, with support for lsp, treesitter and lots of plugins. Includes additional themes for Kitty, Alacritty, iTerm and Fish.
nvim🍨 Soothing pastel theme for Neovim
kanagawa.nvimNeoVim dark colorscheme inspired by the colors of the famous painting by Katsushika Hokusai.
everforest🌲 Comfortable & Pleasant Color Scheme for Vim
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.