Introduction

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 documented
• minimal: the absolute bare minimal for sane default options, highlighting, lsp diagnostics and completions. no documentation in code

Screenshots

featureful:

light:

minimal:

Installation

Requires neovim version 0.12 or greater

Dependencies

• git - for vim builtin package manager. (see :h vim.pack)
• unzip - for mason, specifically for clangd, which the config installs by default
• 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. you'll need, however, to install lsps trough your OS package manager

---

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:

Location

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\