<div align="right"> <a href="https://www.buymeacoffee.com/Hashino" target="_blank"> <img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 24px !important;width: 104px !important;" > </a> </div>

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:

<details> <summary> Linux/MacOS/WSL </summary>

---

<details><summary> featureful version </summary>

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'

</details> <details><summary> light version </summary>

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'

</details> <details><summary> minimal version </summary>

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'

</details>

---

</details> <details> <summary> Windows (Powershell) </summary>

---

<details><summary> featureful version </summary>

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'

</details> <details><summary> light version </summary>

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'

</details> <details><summary> minimal version </summary>

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'

</details>

---

</details>

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\ |