boltlessengineer/NativeVim

github github
neovim
stars 449
issues 1
subscribers 13
forks 12
CREATED

2024-07-09

UPDATED

14 days ago


NativeVim

preview

NativeVim is a Neovim config without plugins

NativeVim is not:

  • a distro[^1]
  • a plugin/package
  • or something that tries to reinvent famous plugins

NativeVim doesn't include:

  • a package manager (e.g. lazy.nvim or rocks.nvim)
  • famous plugins like nvim-lspconfig, nvim-cmp and nvim-treesitter
  • and any other vim/neovim plugins

NativeVim has features like:

  • basic LSP functionalities
  • TreeSitter Highlighting
  • completions

and more!

[!CAUTION] Since this config was developed to demonstrate the most native method, it may be slower or lack features than other configs.

Why?

This is an academical project to see if I can write Neovim config from scratch without any external plugins. So people can understand the Neovim plugin ecosystem more and know what exact plugins they really need.

[!NOTE] I'm not saying "you don't need any of those plugins". Most plugins out there have their own reasons to be used. But if you're curious about the solution without them, this project is for you.

Requirement

  • Neovim v0.11+

How to use

NativeVim doesn't support any plugin manager by default. Just clone it to ~/.config/nativevim and use with NVIM_APPNAME environment variable.

# 1. clone it
git clone https://github.com/boltlessengineer/nativevim.git ~/.config/nativevim

# 2. use it with NVIM_APPNAME
NVIM_APPNAME=nativevim nvim

[!NOTE] NativeVim is just a Neovim config template designed to be read. It's just ~200 lines of lua code. Take some time and read through the entire codebase to see how it works. Feel free to open an issue if you have a different opinion about default config.

Lines of Code

--------------------------------------------------------------------------------
 Language             Files        Lines        Blank      Comment         Code
--------------------------------------------------------------------------------
 Lua                      9          235           45           72          118
 Markdown                 1           69           21            0           48
--------------------------------------------------------------------------------
 Total                   10          304           66           72          166
--------------------------------------------------------------------------------

[^1]: unless you call kickstart.nvim a Neovim distro