NormalNvim
A stable, modular Neovim distribution with IDE features, designed to be forked and customized.
What is NormalNvim?
NormalNvim is a Neovim distribution that provides a pre-configured, modular development environment with built-in IDE features like debugging, testing, and compilation. It solves the problem of spending excessive time setting up and maintaining a complex Neovim configuration by offering a stable, batteries-included base.
Neovim users who want a reliable, fully-featured starting point for their editor configuration, especially those who value stability and the ability to deeply customize their setup.
Developers choose NormalNvim for its emphasis on stability, modularity, and user control—offering a curated set of debugged plugins and tools without abstracting away the underlying configuration, allowing for easy customization and forking.
Overview
A normal Neovim distribution
Use Cases
Best For
- Developers seeking a stable, production-ready Neovim base configuration
- Users who want IDE-like features (debugging, testing, compiling) in Neovim
- Those who prefer a modular setup where every component can be removed or replaced
- Neovim beginners who want a fully-configured environment without the setup hassle
- Advanced users who want to fork and build their own custom Neovim distribution
- Working across multiple programming languages with pre-configured LSP and tooling
Not Ideal For
- Users seeking a minimal, out-of-the-box Neovim experience without the overhead of a full distribution
- Developers who prefer to incrementally build their config from scratch without inheriting a large codebase
- Teams requiring a locked-down, centrally managed editor configuration that discourages forks
Pros & Cons
Pros
Plugins load on-demand for fast startup, as highlighted in the distro features, ensuring super fast performance.
Includes pre-configured compiler, debugger (DAP), test runner (Neotest), and docs generator for top programming languages out of the box.
Plugin version freezing and rollback support via commands like :DistroFreezePluginVersions prevent unexpected breaks.
Every feature is a small, self-contained plugin that can be easily removed or tweaked, adhering to the philosophy of user control.
Cons
Requires Neovim 0.12+, which may not be available on all systems or require manual upgrades, excluding users on older versions.
Optional dependencies must be installed manually post-clone to unlock all features, adding complexity to the initial setup.
The design expects users to fork the repo, introducing git management complexity for updates and customizations, as stated in the philosophy.
Frequently Asked Questions
Related Projects
kickstart.nvimA launch point for your personal nvim configuration
NvChadBlazing fast Neovim framework providing solid defaults and a beautiful UI, enhancing your neovim experience.
LazyVimNeovim config for the lazy
LunarVim🌙 LunarVim is an IDE layer for Neovim. Completely free and community driven.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.