Gruvbox Flat

A dark beautiful Neovim theme written in Lua. [Coming soon] extra themes for Kitty and Alacritty

• Inspired by sainnhe's gruvbox-material but written in lua
• A fork of onedark.nvim

✨ Features

• supports the latest Neovim 0.5 features like TreeSitter and LSP
• minimal inactive statusline (currently bugged)
• vim terminal colors
• darker background for sidebar-like windows
• lualine theme

Plugin Support

• TreeSitter
• LSP Diagnostics
• LSP Trouble
• LSP Saga
• Git Signs
• Git Gutter
• Telescope
• NvimTree
• WhichKey
• Indent Blankline
• Dashboard
• BufferLine
• Lualine
• Lightline
• Neogit
• Hop
• Bat follow this tutorial the .thTheme file is located in extras
• Delta

⚡️ Requirements

• Neovim >= 0.5.0

📦 Installation

Install the theme with your preferred package manager:

vim-plug

Plug 'eddyekofo94/gruvbox-flat.nvim'

packer

use 'eddyekofo94/gruvbox-flat.nvim'

lazy.nvim

return {
    'eddyekofo94/gruvbox-flat.nvim',
    priority = 1000,
    enabled = true,
    config = function()
        vim.cmd([[colorscheme gruvbox-flat]])
    end,
}

🚀 Usage

Enable the colorscheme:

" Vim Script
colorscheme gruvbox-flat

-- Lua
vim.cmd[[colorscheme gruvbox-flat]]

To enable the gruvbox theme for Lualine, simply specify it in your lualine settings:

require('lualine').setup {
  options = {
    theme = 'gruvbox-flat'
    -- ... your lualine config
  }
}

To enable the gruvbox-flat colorscheme for Lightline:

" Vim Script
let g:lightline = {'colorscheme': 'gruvbox-flat'}

To enable darker mode

vim.g.gruvbox_flat_style = "dark"

To enable harder mode

vim.g.gruvbox_flat_style = "hard"

⚙️ Configuration

❗️ configuration needs to be set BEFORE loading the color scheme with colorscheme gruvbox-flat

Option	Default	Description
gruvbox_terminal_colors	true	Configure the colors used when opening a :terminal in Neovim
gruvbox_italic_comments	true	Make comments italic
gruvbox_italic_keywords	true	Make keywords italic
gruvbox_italic_functions	false	Make functions italic
gruvbox_italic_variables	false	Make variables and identifiers italic
gruvbox_transparent	false	Enable this to disable setting the background color
gruvbox_hide_inactive_statusline	false	Enabling this option, will hide inactive statuslines and replace them with a thin border instead. Should work with the standard StatusLine and LuaLine.
gruvbox_sidebars	{}	Set a darker background on sidebar-like windows. For example: ["qf", "vista_kind", "terminal", "packer"]
gruvbox_dark_sidebar	true	Sidebar like windows like NvimTree get a darker background
gruvbox_dark_float	true	Float windows like the lsp diagnostics windows get a darker background.
gruvbox_colors	{}	You can override specific color groups to use other groups or a hex color
gruvbox_theme	{}	You can override specific highlight groups to use other color groups or a hex color

-- Example config in Lua
vim.g.gruvbox_italic_functions = true
vim.g.gruvbox_sidebars = { "qf", "vista_kind", "terminal", "packer" }

-- Change the "hint" color to the "orange" color, and make the "error" color bright red
vim.g.gruvbox_colors = { hint = "orange", error = "#ff0000" }

-- Change the TabLineSel highlight group (used by barbar.nvim) to the "orange" color
vim.g.gruvbox_theme = { TabLineSel = { bg = "orange" } }

-- Load the colorscheme
vim.cmd[[colorscheme gruvbox-flat]]

" Example config in VimScript
let g:gruvbox_italic_functions = 1
let g:gruvbox_sidebars = [ "qf", "vista_kind", "terminal", "packer" ]

" Load the colorscheme
colorscheme gruvbox-flat

Making undercurls work properly in Tmux

To have undercurls show up and in color, add the following to your Tmux config file:

# Undercurl
set -g default-terminal "${TERM}"
set -as terminal-overrides ',*:Smulx=\E[4::%p1%dm'  # undercurl support
set -as terminal-overrides ',*:Setulc=\E[58::2::%p1%{65536}%/%d::%p1%{256}%/%{255}%&%d::%p1%{255}%&%d%;m'  # underscore colours - needs tmux-3.0

🍭 Extras

Extra color configs for Kitty, and Alacritty can be found in extras. To use them, refer to their respective documentation.

• To generate the configs :luafile /lua/gruvbox/extra/init.lua

✅ TODO

• Generate theme for Kitty
• Generate theme for Alacritty
• Add light theme (hopefully one of these days)
• Add hard/darker theme (still has some more improvements to go)