theory-of-everything/nii-nvim

github github
preconfigured-configuration
stars 106
issues 1
subscribers 3
forks 6
CREATED

2021-08-06

UPDATED

2 years ago


Lua Repo_Size

Nii-nvim is a very minimal neovim configuration focused on creating a functional editor with a minimal amount of code. Nii-nvim also keeps the user in mind by being very extensible and well documented. Nii-nvim is finally out of heavy development, thus the project should be considered mostly stable

NOTICE!!!!!!!!

You are looking at the obsolite master branch, if you wish to migrate your configs and pull a new version of nii-nvim, please take a look at the docs!

NOTE: Active development will be moved to my sr.ht repo for this project, It is prefered that you leave issues and patches/pull requests over there, rather than opening issue sand prs on github. However i will still keep an eye on github too.

Why nii-nvim?

There are many neovim configurations that exist (i.e. NvChad, Lunar Vim, etc.), however, many of these configurations suffer from a host of problems.

  • Some configurations (like NvChad), have very abstracted and complex codebases.
  • Others rely on having as much overall functionality as possible (like LunarVim).

While none of this is bad, there are some problems that can arise from these choices:

  • Complex codebases lead to less freedom for end-user extensibility and configuration, as there is more reliance on the maintainer of said code.
  • Users may not use half of what is made available to them simply because they don't need all of that functionality, so all of it may not be necessary.

nii-nvim provides a solution to these problems by providing only the necessary code in order to make a functioning configuration. The end goal of nii-nvim is to be used as a base config for users to extend and add upon, leading to a more unique editing experience.

Also the name is cute. (・3・)

Requirements

  • neovim 5.0 or greater
  • fzf
  • git
  • A Nerd Font
  • ripgrep
  • Python 3

Features

  • Heavy focus on both in-source documentation as well as external documentation.
  • Sane Keybinds for extra added functionality
  • Small codebase for easy extensibility
  • A handful of plugins that build off neovim's strengths
  • Swag (and Minimalism!!)

Contributing

PLEASE BE WARY! If you are thinking of contributing, please wait. I am currently in the process of moving this project to sr.ht. Contributions are always appreciated! If you would like to contribute, please check out CONTIBUTING.md in the repository root. If you like sending patches using git's built-in email features, please send all patches to the nii-nvim-devel mailing list.

Support/Community

If you are looking for help, or are looking for others to interact with, you can join the "official" Matrix room and Discord server

You can also shoot an email to the mailing list:

Screenshots

Functionality Showcase

lsp hop tree docs file_find git

Theme Showcase

Everforest Bluewery Gruvbox-material Nord