lilvim

a lil, modular config

Features

🪴 Self-contained modules
📦 Prioritised built-in functionality
🥟 Deliciously simple to extend

Usage

# Notice the destination folder is lilvim, not nvim
git clone https://github.com/mvllow/lilvim ~/.config/lilvim

# Run lilvim by setting the NVIM_APPNAME environment variable
NVIM_APPNAME=lilvim nvim

Alternatively, you may pull any module into your own config.

Modules

All modules are loaded in init.lua.

lil-editing
General options and keymaps

lil-lsp
Language servers and diagnostics

lil-search
File discovery and text navigation

For not-so-lil module extensions, head over to our wiki

Principles

Heavily inspired by Rational Emacs

Minimal and modular by design

This project includes several self-contained modules which handle their own vim options, keymaps and configurations, contrary to another popular approach of isolating those three categories.

Prioritise built-in Neovim functionality

We have designed lilvim to demonstrate the capabilities of vanilla Neovim and lower the platform's barrier to entry for new users. Our approach encourages users to enjoy the benefits of a lightweight environment by first embracing the platform, then supplementing with plugins as needed.

Statistics

$ tokei ./lilvim/**/*.lua
===============================================================================
 Language            Files        Lines         Code     Comments       Blanks
===============================================================================
 Lua                     4          169           56           96           17
===============================================================================
 Total                   4          169           56           96           17
===============================================================================

There are plenty of projects that provide a framework of abstractions to simplify the learning curve of using Neovim over something like Sublime Text or Visual Studio Code. Check out LazyVim or AstroVim if you want a great batteries-included Neovim configuration or kickstart.nvim—a more robust and feature-rich starting point for your own config.

Contributing

We welcome and appreciate contributions of any kind. Please open an issue to discuss the addition of new modules.