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)
• 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:

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'

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'

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'

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'

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'

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: