• 🎨 Void Linux Inspired - Beautiful green accent colors matching Void's branding
• 🌈 HSLuv Color Space - Perceptually uniform color blending for consistent aesthetics
• 🌳 Full Treesitter Support - Enhanced syntax highlighting for 100+ languages
• 💡 LSP Integration - Semantic tokens, diagnostics, and references
• 🔌 Plugin Ecosystem - First-class support for popular plugins
• ⚡ Performance - Minimal overhead, fast loading
• 🎯 LazyVim Ready - Drop-in support for LazyVim distribution

-- Void Linux Greens
void_green        = "#478061"  -- Primary Void green
void_green_light  = "#5a9d7a"  -- Lighter shade

-- Background & Foreground
bg_primary        = "#0d1117"  -- Deep dark background
fg_primary        = "#c9d1d9"  -- Light foreground

-- Semantic Colors
blue              = "#78a9ff"  -- Info, types
red               = "#ff6b6b"  -- Errors
orange            = "#ffa94d"  -- Warnings
pink              = "#ff7eb6"  -- Functions
green             = "#42be65"  -- Strings, success
purple            = "#be95ff"  -- Keywords
cyan              = "#82cfff"  -- Numbers

Create ~/.config/nvim/lua/plugins/void.lua:

return {
  "BJZR/void.nvim",
  -- config..
}

return {
  "BJZR/void.nvim",
  lazy = false,
  priority = 1000,
  config = function()
    require("void")
  end,
}

use {
  "BJZR/void.nvim",
  config = function()
    require("void")
    vim.cmd("colorscheme void")
  end,
}

git clone https://github.com/BJZR/void.nvim.git ~/.config/nvim/lua/void

Then add to your init.lua:

require("void")
vim.cmd("colorscheme void")

1. Install the theme using any method above
2. Restart Neovim
3. Verify installation:

   :colorscheme void
   :echo g:colors_name

• Neovim >= 0.9.0
• termguicolors enabled
• Terminal with truecolor support

Make sure you have this in your configuration:

vim.opt.termguicolors = true

void.nvim includes hand-crafted support for:

• ✅ Treesitter - Advanced syntax highlighting
• ✅ LSP - Language Server Protocol integration
• ✅ Diagnostic - Error, warning, info, hint highlighting

• ✅ Telescope - Fuzzy finder
• ✅ Neo-tree / NvimTree - File explorers
• ✅ Which-key - Keybinding helper
• ✅ Alpha / Dashboard - Start screens
• ✅ Lualine - Status line
• ✅ Bufferline - Buffer tabs
• ✅ Indent Blankline - Indentation guides

• ✅ GitSigns - Git decorations
• ✅ Neogit - Git interface
• ✅ DiffView - Diff viewer

• ✅ nvim-cmp - Completion menu
• ✅ nvim-notify - Notification manager

• ✅ Markdown - Enhanced markdown support
• ✅ Render-markdown - Inline rendering

Clean and minimal start screen with Void green accents

Treesitter-powered syntax highlighting with semantic tokens

Beautiful search interface with matching highlights

Clear git status with intuitive color coding

require("void")
vim.cmd("colorscheme void")

-- Override highlights after theme loads
vim.api.nvim_set_hl(0, "Function", { fg = "#custom", bold = true })

local void = require("void").void

-- Use colors in your configuration
vim.api.nvim_set_hl(0, "MyCustomGroup", { 
  fg = void.base07,  -- Void green
  bg = void.base00   -- Dark background
})

void.nvim looks best in terminals with truecolor support:

• Alacritty ✅ (Recommended)
• Kitty ✅
• WezTerm ✅
• iTerm2 ✅ (macOS)
• Windows Terminal ✅

echo $COLORTERM  # Should show: truecolor or 24bit

Most modern terminals support truecolor by default. If not:

# Add to ~/.bashrc or ~/.zshrc
export COLORTERM=truecolor

1. Clear cache:

   rm -rf ~/.local/share/nvim/lazy
   rm -rf ~/.local/state/nvim/lazy

2. Verify installation:

   :echo g:colors_name
   :Lazy sync

3. Check for errors:

   :messages
   :checkhealth

1. Enable termguicolors:

   vim.opt.termguicolors = true

2. Check terminal:

   echo $TERM  # Should be: xterm-256color or similar

3. Test truecolor:

   curl -s https://gist.githubusercontent.com/lifepillar/09a44b8cf0f9397465614e622979107f/raw/24-bit-color.sh | bash

Make sure plugins are loaded after the colorscheme:

{
  "BJZR/void.nvim",
  lazy = false,
  priority = 1000,  -- Load before other plugins
  config = function()
    require("void")
    vim.cmd("colorscheme void")
  end,
},

Contributions are welcome! Here's how you can help:

1. Report bugs - Open an issue with details
2. Request features - Suggest improvements
3. Submit PRs - Fix bugs or add features
4. Share feedback - Let us know what you think

# Clone the repository
git clone https://github.com/BJZR/void.nvim.git
cd void.nvim

# Make changes to lua/void/

# Test locally
nvim --cmd "set rtp+=."

MIT License - see LICENSE for details.

• Inspired by Void Linux - The distribution that started it all
• Color blending based on HSLuv - Perceptually uniform color space
• Structure inspired by oxocarbon.nvim - Excellent Fennel-based theme
• Built for LazyVim and Neovim

• GitHub: BJZR/void.nvim
• Issues: Report a bug
• Discussions: Join the conversation