Tokyo Night (Night) theme by default
The space key shows all you can do
If you are new here don't forget to check the wiki.
You can preview it here
wget -q https://raw.githubusercontent.com/NormalNvim/installer/main/installer.sh && chmod +x installer.sh && ./installer.sh# Strongly recommended: Fork the repo and clone YOUR fork.
git clone https://github.com/NormalNvim/NormalNvim.git ~/.config/nvim# Strongly recommended: Fork the repo and clone YOUR fork.
git clone https://github.com/NormalNvim/NormalNvim.git %USERPROFILE%\AppData\Local\nvim && nvimThis is only necessary if you installed NormalNvim by cloning manually. To unlock all features you will have to install the dependencies.
- ⚡ Lazy: Plugins are loaded lazily, providing super fast performance.
- 😎 Plugins are self-contained: Allowing you to easily delete what you don't want.
- 🔋 Batteries included: Most plugins you will ever need are included and debugged by default. Get the best user experience out of the box and forget about nasty bugs in your Neovim config.
- 🤖 IDE tools: We ship Compiler.nvim (compiler), DAP (debugger), Neotest (test runner), and Dooku.nvim (docs generator)
- 🐞 IDE parsers: Linters, Formatters, LSP, Treesitter... preinstalled, preconfigured and ready to code for the top 12 most popular programming languages.
- 🔒 Plugin version lock: You can choose "stable" or "nightly" update channels. Or if you prefer, use :NvimFreezePluginVersions to create your own stable versions!
- 🔙 Rollbacks: You can easily recover from a nvim distro update using :NvimRollbackRestore
- 🔥 Hot reload: Every time you change something in your config, the changes are reflected on nvim on real time without need to restart.
- 📱 Phone friendly: You can also install it on Android Termux. Did you ever have a compiler in your pocket? 😉
- ⌨️ Alternative mappings: By default the distro uses qwerty, but colemak-dh can be found here.
- 🐶 100% agnostic: Any plugin NormalNvim ship, can be used in any distro.
- ❤️ We don't treat you like you are stupid: Code comments guide you to easily customize everything. We will never hide or abstract stuff from you.
You are expected to fork the project before cloning it. So you are the only one in control. It is also recommended to use neovim's appimage.
This is not a distro you are expected to update often from upstream. It is meant to be used as a base to create your own distro.
NormalNvim won't be the next /r/UnixPorn sensation. It is a normal nvim config you can trust 100% will never unexpectedly break while you are working. Nothing flashy. Nothing brightful. Just bread and butter.
The next relevant commands are provided by distroupdate.nvim
| Command | Description |
|---|---|
| :NvimUpdateConfig | To update the distro from git origin. Local uncommited changes will be lost |
| :NvimRollbackRestore | To revert the last :NvimUpdateConfig |
| :NvimFreezePluginVersions | To save your current plugin versions into lazy_versions.lua |
Please before opening an issue, check the astrocommunity repo where you can find help about how to install and configure most plugins.
-
NormalNvim is not working. How can I know why?
:checkhealth base -
Supports Windows? Yes, 100%. This is not necessary, but we strongly recommend you to launch NormalNvim using WLS so you can install the required dependencies to unlock all features.
-
How can I disable the tabline? You can delete the plugin heirline.
-
How can I disable the animations? You can delete the plugin mini.animate. In case you only want to disable some animations look into the plugin docs.
-
How can I use
Ask chatgpt? On your operative system, set the next env var. You can get an API key from chatgpt's website.
OPENAI_API_KEY="my_key_here"- What scenarios are not covered by this distro?
- Kubernetes: We do not provide a kubernetes plugin. But we recommend using friendly-snippets, to quickly write code, and overseer.nvim to run kubernetes commands from inside nvim without having to wait for the server response.
- e2e testing: We do not provide an e2e plugin. But we do provide the :TestNodejsE2e command you can customize on /lua/base/3-autocmds.lua along with all the other testing commands. You can also rename the commands to anything you want in case you don't use nodejs.
If you want to help me, please star this repository to increase the visibility of the project.
Originally it took AstroNvim as base. But implements this VIM config with some extras. Code has been simplified while retaining its core features. NormalNvim has also contributed to the code of many of the plugins included, in order to debug them and make them better.
Special thanks to LeoRed04 for designing the logo.
Did you know NormalNvim was the first Neovim distro to ship a compiler that support 22+ programming languages out of the box?
During 2024, add a installer to take care of installing the system dependencies, which seems to be the main friction point people find.- During 2024, create CD actions that can be triggered manually to ensure the dependencies install correctly (sometimes distros will change dependency names). → Add it to NormalNvim/installer
- Once we remove all complexity we possibly can from all configs, lets's start moving to Neovim 0.10, as it is likely to be officially released around april of this year.
- Once nvim 0.10 is officially released, replace
get_active_clientsbyget_clients. - During 2024, add a toolbar for Compiler.nvim so users have a button to compile and manage their build automation utilities and current build_type in a friendly way.
- During 2024, create a landing page. Pretty much it's gonna be the same thing we have on the wiki, but with sparkles.