Neovim Setup

Getting Started with Neovim

Neovim is a modernized, highly extensible version of the classic Vim text editor. It's fast, efficient, and runs in your terminal, which makes it a powerful choice for web development. By keeping your hands on the keyboard and away from the mouse, you can streamline your workflow significantly.

As a terminal-based editor, Neovim offers unmatched customization, exceptional performance, and the ability to work seamlessly in remote environments.

This guide will walk you through installing Neovim, setting up a basic configuration for web development, and adding a few essential plugins to create a productive coding environment.

Installation

Installing Neovim is straightforward across different operating systems. The most common way is to use a package manager.

On macOS, you can use Homebrew:

brew install neovim

On Windows, you can use Scoop or Chocolatey:

# Using Scoop
scoop install neovim

# Using Chocolatey
choco install neovim

On Linux, use your distribution's package manager. For Debian/Ubuntu:

sudo apt-get install neovim

For Arch Linux:

sudo pacman -S neovim

Once installed, you can run Neovim from your terminal by typing nvim.

Your First Configuration

Neovim's configuration is managed through a special file. Modern Neovim setups use Lua for configuration, which is fast and powerful. You'll create your configuration file at ~/.config/nvim/init.lua.

First, create the directory:

mkdir -p ~/.config/nvim

Now, create the init.lua file inside that directory and add some basic settings to improve the editing experience.

-- ~/.config/nvim/init.lua

-- Set the leader key to space
vim.g.mapleader = ' '

-- Set line numbers
vim.opt.number = true
vim.opt.relativenumber = true

-- Set indentation
vim.opt.tabstop = 2
vim.opt.softtabstop = 2
vim.opt.shiftwidth = 2
vim.opt.expandtab = true

-- Enable mouse support
vim.opt.mouse = 'a'

This simple configuration sets the leader key (a prefix for many custom shortcuts) to the spacebar, enables line numbers, configures tabs to be two spaces wide (a common standard in web development), and turns on mouse support. Save the file, restart nvim, and you'll see the changes.

Essential Plugins

Plugins are what make Neovim truly powerful. To manage them, we'll use a plugin manager called lazy.nvim. It automatically installs and updates plugins and only loads them when needed, keeping startup times fast.

First, you need to install it. Add the following code to the top of your init.lua file. It will automatically download and set up lazy.nvim the next time you start Neovim.

-- ~/.config/nvim/init.lua

-- Install lazy.nvim plugin manager
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
if not vim.loop.fs_stat(lazypath) then
  vim.fn.system({
    "git",
    "clone",
    "--filter=blob:none",
    "https://github.com/folke/lazy.nvim.git",
    "--branch=stable", -- latest stable release
    lazypath,
  })
end
vim.opt.rtp:prepend(lazypath)

-- The rest of your configuration will go below this line
-- require('lazy').setup(...) is next

Now, let's configure lazy.nvim to install a few key plugins for web development. Add this below the installation script in your init.lua.

require('lazy').setup({
  -- For better syntax highlighting
  'nvim-treesitter/nvim-treesitter',

  -- Autocompletion engine
  'hrsh7th/nvim-cmp',
  'hrsh7th/cmp-nvim-lsp', -- Language server completions
  'hrsh7th/cmp-path', -- File path completions

  -- Language Server Protocol (LSP) support
  'neovim/nvim-lspconfig',

  -- Git integration
  'lewis6991/gitsigns.nvim',
})

-- Your previous settings (line numbers, etc.) go here

Let's break down what these plugins do:

nvim-treesitter: Provides faster and more accurate syntax highlighting for many languages, including HTML, CSS, and JavaScript. It understands your code's structure, not just keywords.
nvim-cmp & sources: A powerful autocompletion engine. It provides suggestions as you type, pulling from sources like the Language Server Protocol (cmp-nvim-lsp) for intelligent, context-aware completions.
nvim-lspconfig: A collection of default configurations for the Language Server Protocol (LSP). LSP allows Neovim to understand your code on a deeper level, providing features like go-to-definition, error checking, and smart autocompletion.
gitsigns.nvim: Adds Git decorations to the sign column (the column where line numbers appear). You can see which lines have been added, modified, or deleted at a glance.

When you save this init.lua and restart nvim, lazy.nvim will open a window and install these plugins for you. Once it's done, you'll have a lightweight yet capable setup for modern web development.

With this foundation, you have a development environment that is both fast and tailored to your needs. From here, you can explore more plugins and customizations as you become more comfortable.

Interactive Infinite Scroll Brain Animation