About this project

mini.nvim is an all-in-one but highly modular plugin library for Neovim 0.10 and newer. Its 45+ Lua modules can be installed and enabled independently, allowing users to adopt only the functionality they need. The modules share consistent setup, configuration, naming, highlighting, and buffer conventions. Text-editing modules cover text objects, alignment, comments, movement of selections, operators, autopairs, snippets, splitting and joining arguments, surrounding text, completion, signature help, and key mappings. General workflow features include configuration presets, bracket-based navigation, buffer removal, key clues, command-line tweaks, diff hunk handling, filesystem browsing and manipulation, Git integration, user input, fuzzy picking, session management, and file-visit tracking. Appearance modules provide animations, color schemes and color customization, icons, cursor-word highlighting, text-pattern highlighting, indent visualization, minimaps, notifications, start screens, status columns and lines, tab lines, and trailing-space handling. Additional modules generate Neovim help documentation, provide fuzzy matching, and test Neovim plugins. Modules are enabled with their setup() function and accept full or partial configuration tables. Runtime configuration is stored on a generated global Lua object, and selected settings can support buffer-local configuration. Core functionality can be disabled globally or for individual buffers, non-error feedback can be silenced, and output appearance can be customized through highlight groups. The project intentionally avoids filetype- and language-specific implementations, while allowing relevant behavior to be tuned through buffer options or local configuration. Installation examples are provided for Neovim's vim.pack, manual Git installation, and lazy.nvim. The main branch contains the latest development version, while the stable branch is updated with released versions. The package also includes dark and light variants of several color schemes, including miniwinter, minispring, minisummer, miniautumn, randomhue, minicyan, and minischeme. The README separately identifies planned modules—such as folds, terminals, quickfix enhancements, and window management—as future work rather than current capabilities.