minimal.nvim is a neovim 0.12 configuration written in lua. this is not meant
to be a distribution, but rather a template for you to build upon and/or a
reference for how to configure neovim using lua in the latest version.
it comes in three flavors: featureful, light and minimal.
featureful: sane default options, highlighting, lsp diagnostics, completions, fuzzy finding and some quality-of-life/appearance plugins. heavily documented.light: sane default options, highlighting, lsp diagnostics, completions and fuzzy finding. heavily documentedminimal: the absolute bare minimal for sane default options, highlighting, lsp diagnostics and completions. no documentation in code
Requires neovim version 0.12 or greater
git- for vim builtin package manager. (see:h vim.pack)ripgrep- for fuzzy finding- clipboard tool: xclip/xsel/win32yank - for clipboard sharing between OS and neovim (see
h: clipboard-tool) - a nerd font (ensure the terminal running neovim is using it)
Note
for the minimal version, only git is required.
to install run:
Linux/MacOS/WSL
featureful version
mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim && wget https://raw.githubusercontent.com/Hashino/minimal.nvim/refs/heads/featureful/init.lua -O "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim/init.lua && nvim -c ':e $MYVIMRC'light version
mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim && wget https://raw.githubusercontent.com/Hashino/minimal.nvim/refs/heads/light/init.lua -O "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim/init.lua && nvim -c ':e $MYVIMRC'minimal version
mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim && wget https://raw.githubusercontent.com/Hashino/minimal.nvim/refs/heads/minimal/init.lua -O "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim/init.lua && nvim -c ':e $MYVIMRC'Windows (Powershell)
featureful version
mkdir -Force $env:LOCALAPPDATA\nvim\ && curl https://raw.githubusercontent.com/Hashino/minimal.nvim/refs/heads/featureful/init.lua -o $env:LOCALAPPDATA\nvim\init.lua && nvim -c ':e $MYVIMRC'light version
mkdir -Force $env:LOCALAPPDATA\nvim\ && curl https://raw.githubusercontent.com/Hashino/minimal.nvim/refs/heads/light/init.lua -o $env:LOCALAPPDATA\nvim\init.lua && nvim -c ':e $MYVIMRC'minimal version
mkdir -Force $env:LOCALAPPDATA\nvim\ && curl https://raw.githubusercontent.com/Hashino/minimal.nvim/refs/heads/minimal/init.lua -o $env:LOCALAPPDATA\nvim\init.lua && nvim -c ':e $MYVIMRC'or download init.lua via the browser from the respective branch to the neovim config directory:
Neovim's configurations are located under the following paths, depending on your OS:
| OS | PATH |
|---|---|
| Linux, MacOS | $XDG_CONFIG_HOME/nvim, ~/.config/nvim |
| Windows | %localappdata%\nvim\ |