This Neovim config is written from scratch and is my daily driver for 95% of my programming work. The main focus of this Neovim config is to stay close to the native Neovim experience while still providing some nice-to-haves. My personal motivation for this is to avoid my annoyance of having to essentially relearn Neovim anytime I attempt to edit some files on a remote server or some other machine with a default-like Neovim config.
This config is built mainly for Arch-based Linux distributions, but may work on many other distributions (no guarantees provided). I have no clue about this config's MacOS and Windows support (so assume unsupported). The install script does have some logic to support MacOS, but this remains untested as I do not own a Mac to test it with.
The following are the config's dependencies, bar language server binaries and plugins installed through lazy.nvim:
- Neovim v0.12.0+
- Tree-sitter CLI v0.26.1+
- A C compiler in your PATH.
There are multiple ways of installing the config. Method A is automatic and recommended.
Warning
This script installs Neovim from your distro's official repository, and as of 2026-08-09, Neovim v0.12.0+ is relatively new. Therefore, many distributions, most notably Debian and Ubuntu LTS and probably many more, might not have Neovim v0.12.0+ in order to uphold their security and stability guarantee. In such cases an older version of Neovim will be installed and this will cause issues unless you manually install a more up-to-date version (v0.12.0+) from somewhere else.
The command below executes an install script and should automagically install the Neovim
config and its dependencies, except the language server binaries. It works on Linux
distributions using pacman, apt, or dnf as package managers and (maybe) MacOS with
Homebrew. A backup of your current Neovim config is automatically
created before installation happens.
curl -L "https://raw.githubusercontent.com/borgaar/nvim/main/install.sh" | /bin/bashWarning
Do not install Tree-sitter CLI from NPM.
- Create a backup of your current config if you have one:
mv "$HOME/.config/nvim" "$HOME/.config/nvim.backup"
- Make sure you have Neovim v0.12.0+. If not, install it.
- Install Tree-sitter CLI v0.26.1+. It can probably be found in your distribution's official repositories. If not, follow these instructions.
- Install the Neovim config:
git clone "https://github.com/borgaar/nvim" "$HOME/.config/nvim"