This is my Neovim config.
Note
It was started as a fork of dam9000/kickstart-modular.nvim, and I highly recommend it if you like to create your own config yourself (like I did). I do not support this config on Windows, but it might work - check the kickstart repo for Windows-specific installation instructions.
Config.nvim targets only the latest 'stable' Neovim. If you are experiencing issues, please make sure you have the latest version.
External Requirements:
- Basic utils:
git,make,unzip, C Compiler (gcc). - ripgrep.
- Clipboard tool (
xclip/xselor other depending on platform). - You might need some extra tool (e.g.
npm) used by Mason to auto-install formatter/LSP tools. - A Nerd Font: optional, provides various icons.
- If you have it set
vim.g.have_nerd_fontininit.luato true. - If you chose "Propo" font kind set
vim.g.nerd_font_propoininit.luato true.
- If you have it set
Note
Backup your previous configuration (if any exists)
Neovim's configurations are located under the following paths, depending on your OS:
| OS | PATH |
|---|---|
| Linux, MacOS | $XDG_CONFIG_HOME/nvim, ~/.config/nvim |
Fork this repo so that you have your own copy that you can modify, then install by cloning the fork to your machine using one of the commands below, depending on your OS.
Note
Your fork's URL will be something like this:
https://github.com/<your_github_username>/config.nvim.git
Note
If following the recommended step above (i.e., forking the repo), replace
powerman with <your_github_username> in the commands below
Linux and Mac
git clone https://github.com/powerman/config.nvim.git "${XDG_CONFIG_HOME:-$HOME/.config}"/nvimStart Neovim
nvimThat's it! Lazy will install all the plugins you have. Use :Lazy to view
the current plugin status. Hit q to close the window.
If you are on another machine, you can do :Lazy restore, to update all your plugins to the
version from the lockfile.
The Only Video You Need to Get Started with Neovim
-
What should I do if I already have a pre-existing Neovim configuration?
-
You should back it up and then delete all associated files.
-
This includes your existing init.lua and the Neovim files in
~/.localwhich can be deleted withrm -rf ~/.local/share/nvim/
-
-
Can I keep my existing configuration in parallel?
-
Yes! You can use NVIM_APPNAME
=nvim-NAMEto maintain multiple configurations. For example, you can install the configuration in~/.config/nvim-powermanand create an alias:alias nvim-powerman='NVIM_APPNAME="nvim-powerman" nvim'
When you run Neovim using
nvim-powermanalias it will use the alternative config directory and the matching local directory~/.local/share/nvim-powerman. You can apply this approach to any Neovim distribution that you would like to try out.
-
Below you can find OS specific install instructions for Neovim and dependencies.
After installing all the dependencies continue with the Install Config step.
Ubuntu Install Steps
sudo add-apt-repository ppa:neovim-ppa/unstable -y
sudo apt update
sudo apt install make gcc ripgrep unzip git xclip neovimDebian Install Steps
sudo apt update
sudo apt install make gcc ripgrep unzip git xclip curl
# Now we install nvim
curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux-x86_64.tar.gz
sudo rm -rf /opt/nvim-linux-x86_64
sudo mkdir -p /opt/nvim-linux-x86_64
sudo chmod a+rX /opt/nvim-linux-x86_64
sudo tar -C /opt -xzf nvim-linux-x86_64.tar.gz
# make it available in /usr/local/bin, distro installs to /usr/bin
sudo ln -sf /opt/nvim-linux-x86_64/bin/nvim /usr/local/bin/Fedora Install Steps
sudo dnf install -y gcc make git ripgrep fd-find unzip neovimArch Install Steps
sudo pacman -S --noconfirm --needed gcc make git ripgrep fd unzip neovim