Configuration


Neovim configuration is probably one of the most commonly-asked questions that new users ask.

The purpose of this chapter is to provide a common-sense guide for new users to get up to speed quickly, or for more advanced users who want to get a bit more control configuring Neovim.

Pre-Built Configuration

For many new users, it might make sense to start with one of the community-built configurations. These provide good out-of-the-box experiences, and allow you to quickly get started with Neovim. There are several popular options available:

Each of these provide details for installing and customizing, and are a great place to start.

Starter Configuration

Over time you may decide that you want a bit more control over your setup, but you don't necessarily want a fully-custom configuration from scratch. In this case, a good place to place to start is kickstart.nvim.

kickstart.nvim provides a well-documented, single-file configuration that installs a selection of popular plugins that can get you started quickly.

To get started with kickstart.nvim, simply follow along the next few sections until we get to init.lua, then follow the steps there. Once you get started with kickstart.nvim, the rest of this chapter will still be helpful for learning how you can customize your configuration as your needs evolve.

Fully-Custom Configuration

Finally, for those that want to start from scratch and understand every line in their configuration. The material in this chapter builds a basic configuration similar to that in kickstart.nvim, and does so in a way that the user can understand what is included and how to change it going forward. The goal is to provide a basic configuration that provides a foundation upon which your fully-custom configuration can evolve.

Let's get started.