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. Individual modules rely on mini.deps for managing packages. You may opt for your own package manager or manually cloning the required dependencies. See :help packages for more information on the builtin package manager.

Modules

All modules are loaded in init.lua. If using a standalone module, please handle installing the necessary dependencies. For the best support, we recommended installing mini.deps.

lil-editing General options and keymaps

lil-formatting Formatters and only formatters

lil-lsp Language servers and diagnostics

lil-search File discovery and text navigation

lil-ui Treesitter and interface options

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 options, keymaps, and plugins, 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

~/.config/lilvim (main)> tokei **/*.lua
===============================================================================
 Language            Files        Lines         Code     Comments       Blanks
===============================================================================
 Lua                     6          308          159          122           27
===============================================================================
 Total                   6          308          159          122           27
===============================================================================

Related

There are plenty of projects that provide a framework of abstractions to simplify the learning curve of using Neovim over something like VSCode. Check out LunarVim or AstroVim if you want a great batteries-included Neovim configuration.

Contributing

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