Important : You need Neovim 0.10+
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 && nvim
This is only necessary if you installed NormalNvim by cloning manually. To unlock all features you will have to install the dependencies.
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 |
---|---|
:DistroUpdate | To update the distro from git origin. Local uncommited changes will be lost. |
:DistroUpdateRevert | To revert the last :DistroUpdate . |
:DistroFreezePluginVersions | To save your current plugins 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
Why can't I see the icons? You must install the nerdfont version of your font, and use it on your terminal. Alternatively you can edit base/icons/nerd_font.lua
to manually specify your own icons.
How can I install a new colorscheme? Go to plugins/2-ui.lua
, and add the theme you want. Re-open nvim and now you can set your new colorcheme on base/1-options.lua
. You can also preview all your installed themes with <space>+ft
.
How can I change the user interface? We use the plugin heirline to create the user interface. You can re-order or change any component of your user interface in plugins/2-ui.lua
. If you preffer the classic vim appearance, you can delete the plugin.
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"
One of the biggest challenges NormalNvim face is marketing. So share the project and tell your friends!
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?
tsserver
to ts_ls
(as the former has been renamed in lspconfig). → see mason-registry issuedistroupdate.nvim
common LISP
.COBOL
.