Neovim Configuration

Neovim is my primary text editor, configured with a modern setup using lazy.nvim for plugin management.

Features #

• lazy.nvim - Fast, modern plugin manager
• LSP - Language Server Protocol for IDE-like features
• Treesitter - Better syntax highlighting and parsing
• fzf/telescope - Fuzzy finding for files, buffers, and more
• Git integration - Gitsigns, fugitive, and diffview

Setup #

Installation #

Via mise (recommended):

mise install neovim

Or from source/package manager:

# Ubuntu/Debian
sudo apt install neovim

# Arch Linux
sudo pacman -S neovim

# macOS
brew install neovim

Configuration Structure #

nvim/.config/nvim/
├── init.lua                 # Entry point
├── lazy-lock.json          # Plugin lockfile
└── lua/
    ├── config/
    │   ├── keymaps.lua     # Key bindings
    │   ├── options.lua     # Vim options
    │   └── lazy.lua        # Plugin manager setup
    └── plugins/            # Individual plugin configs

Plugin Categories #

Core #

• lazy.nvim - Plugin manager
• plenary.nvim - Lua utility library
• nvim-web-devicons - File type icons

LSP & Completion #

• nvim-lspconfig - LSP configuration
• mason.nvim - LSP server installer
• nvim-cmp - Completion engine
• LuaSnip - Snippet engine

Fuzzy Finding #

• telescope.nvim - Fuzzy finder framework
• telescope-fzf-native - Native fzf integration
• telescope-ui-select - UI selection enhancement

Git #

• gitsigns.nvim - Git decorations in gutter
• vim-fugitive - Git commands
• diffview.nvim - Enhanced diff viewing

UI #

• lualine.nvim - Status line
• bufferline.nvim - Tab-like buffer line
• nvim-tree.lua - File explorer
• which-key.nvim - Keybinding helper
• indent-blankline.nvim - Indentation guides

Editing #

• nvim-treesitter - Syntax tree parser
• vim-surround - Surround text objects
• vim-commentary - Comment toggling
• nvim-autopairs - Auto-close brackets
• vim-sleuth - Automatic indentation detection

Themes #

• tokyonight.nvim - Main color scheme

Key Concepts #

Lazy Loading #

Plugins are loaded on demand to improve startup time:

-- Load only when opening a file
{ "nvim-treesitter", event = "BufReadPost" }

-- Load on specific command
{ "neo-tree.nvim", cmd = "Neotree" }

-- Load on key mapping
{ "telescope.nvim", keys = { "<leader>ff", "<leader>fg" } }

LSP Setup #

Language servers are configured via mason and lspconfig:

require("mason").setup()
require("mason-lspconfig").setup({
    ensure_installed = { "lua_ls", "rust_analyzer", "pyright" }
})

Custom Keymaps #

All keymaps are in lua/config/keymaps.lua:

-- Leader key
vim.g.mapleader = " "

-- Quick save
vim.keymap.set("n", "<leader>w", "<cmd>w<cr>")

-- Better window navigation
vim.keymap.set("n", "<C-h>", "<C-w>h")
vim.keymap.set("n", "<C-j>", "<C-w>j")
vim.keymap.set("n", "<C-k>", "<C-w>k")
vim.keymap.set("n", "<C-l>", "<C-w>l")

Daily Workflow #

File Navigation #

• <leader>ff - Find files
• <leader>fg - Live grep
• <leader>fb - Find buffers
• <leader>fh - Help tags

Code Navigation #

• gd - Go to definition
• gr - Go to references
• gi - Go to implementation
• K - Hover documentation

Git #

• ]c / [c - Next/previous hunk
• <leader>hs - Stage hunk
• <leader>hr - Reset hunk
• <leader>hp - Preview hunk

Performance Tips #

1. Check startup time: nvim --startuptime startup.log
2. Profile plugins: :Lazy profile
3. Disable unused providers:

vim.g.loaded_python3_provider = 0
vim.g.loaded_ruby_provider = 0
vim.g.loaded_perl_provider = 0
vim.g.loaded_node_provider = 0

See Also #

🚀 Getting Started | lazy.nvim

lazy.nvim is a modern plugin manager for Neovim.

lazy.folke.io

GitHub - neovim/nvim-lspconfig: Quickstart configs for Nvim LSP

Quickstart configs for Nvim LSP. Contribute to neovim/nvim-lspconfig development by creating an account on GitHub.

GitHub · github.com

GitHub - nvim-telescope/telescope.nvim: Find, Filter, Preview, Pick. All lua, all the time.

Find, Filter, Preview, Pick. All lua, all the time. - nvim-telescope/telescope.nvim

GitHub · github.com