Getting started
Features
- ⚡ Minimal, clean, and distraction-free setup
- 🎯 Thoughtful defaults that respect core Neovim behavior
- ⚙️ Fully modular configuration, easy to customize
- 🧭 Clean navigation — no tabs, no file tree, no distractions
- 🧩 Carefully curated plugins, no unnecessary bloat
Requirements
Basics
Required for full functionality
- ripgrep and fd used by
Telescope(more info on dependencies) - nvim-treesitter-cli and C compiler for
nvim-treesitter(more info on dependencies) - and a terminal that support true color and undercurl:
Dependencies
These tools must be installed for the setup to work properly. It is not necessary to install all of them. Install only the ones you need or plan to use.
nvim-treesitter
1- Required nvim-treesitter-cli:
2- Required a C compiler:
- Linux
- macOS
- Windows
Ubuntu / Debian
sudo apt install build-essential
Arch
sudo pacman -S base-devel
Fedora
sudo dnf groupinstall "Development Tools"
xcode-select --install
By download link (✔ Select Desktop development with C++)
https://visualstudio.microsoft.com/es/downloads/
Git Bash / MSYS2 / WSL
sudo dnf groupinstall "Development Tools"
Final check if tree-sitter-cli and C compiler is installed
cc --version
tree-sitter --version
Clipboard support
Neovim requires an external tool to integrate with the system clipboard.
- Linux
- macOS
- Windows
First, check which display server you are using:
echo $XDG_SESSION_TYPE
- If it returns
wayland- you are using Wayland - If it returns
x11- you are using X11
- Wayland (wl-clipboard)
- X11 (xclip)
sudo apt install wl-clipboard
sudo apt install xclip
On macOS, Neovim uses the system clipboard through the built-in pbcopy and pbpaste utilities.
No additional configuration is required as long as Neovim is installed with clipboard support.
To verify clipboard support:
nvim --version | grep clipboard
If you see +clipboard, Neovim is correctly configured.
If Neovim was installed via Homebrew, clipboard support is enabled by default:
brew install neovim
On Windows, Neovim integrates with the system clipboard using external clipboard helpers.
- Windows (Native)
- WSL
Neovim uses win32yank.exe, which is included by default in official Neovim releases.
No extra setup is needed if you installed Neovim from the official installer or via winget.
Verify clipboard support:
nvim --version | findstr clipboard
If you are using Neovim inside WSL, clipboard integration requires an additional tool.
Install win32yank.exe and make sure it is available in your $PATH.
Example (from inside WSL):
sudo apt install wget unzip
wget https://github.com/equalsraf/win32yank/releases/latest/download/win32yank-x64.zip
unzip win32yank-x64.zip
sudo mv win32yank.exe /usr/local/bin/
If needed, add the following to your Neovim configuration:
vim.g.clipboard = {
name = "win32yank",
copy = {
["+"] = "win32yank.exe -i --crlf",
["*"] = "win32yank.exe -i --crlf",
},
paste = {
["+"] = "win32yank.exe -o --lf",
["*"] = "win32yank.exe -o --lf",
},
}
ripgrep
Used by Telescope for project-wide text search. See the installation instructions in the ripgrep official repository
fd
Used by Telescope for fast file search. See the installation instructions in the fd official repository
Lazygit (optional)
Lazygit is optional. Install it only if you want to use the terminal-based Git interface. See the installation instructions in the Lazygit official repository
Node.js (optional)
Required by some LSP servers such as tsserver, eslint, volar, cssls, etc.
Using fnm (Node version manager) https://github.com/Schniz/fnm (You can use another method to install Node)
fnm install --lts
TypeScript (optional)
Required for TypeScript language server.
npm install -g typescript typescript-language-server