Neovim Configuration

LazyVim-based Neovim configuration with Catppuccin theme and custom keymaps

Overview

This Neovim configuration is built on LazyVim, a pre-configured Neovim setup that provides a solid foundation with sensible defaults and a plugin ecosystem.

LazyVim Base

LazyVim provides:

• Modern plugin management via lazy.nvim
• Pre-configured LSP, linting, and formatting
• File explorer, fuzzy finder, and git integration
• Catppuccin theme integration
• Extensive keybindings

Refer to the LazyVim documentation for the full feature set and default keybindings.

Configuration Structure

~/.config/nvim/
├── init.lua                    # Entry point
├── lua/
│   ├── config/
│   │   ├── autocmds.lua       # Auto commands
│   │   ├── keymaps.lua        # Custom keymaps
│   │   ├── lazy.lua           # Lazy.nvim bootstrap
│   │   └── options.lua        # Vim options
│   └── plugins/
│       ├── catppuccin.lua     # Theme configuration
│       ├── core.lua           # Core plugin overrides
│       └── neo-tree.lua       # File explorer config
├── lazy-lock.json             # Plugin version lock
└── stylua.toml                # Lua formatter config

Entry Point

The configuration starts simple:

-- init.lua
require("config.lazy")

This bootstraps lazy.nvim and loads all configuration modules.

Custom Options

Minimal options override LazyVim defaults:

-- lua/config/options.lua
vim.g.root_spec = { "cwd" }

This sets the root directory detection to use the current working directory.

Custom Keymaps

File Explorer

vim.keymap.set("n", "<leader>e", "<cmd>Neotree<cr>", { desc = "Toggle Neo-tree" })

• <leader>e - Toggle Neo-tree file explorer

File Finding

vim.keymap.set("n", "<leader> ", "<cmd>Telescope find_files<cr>", { desc = "Find Files" })
vim.keymap.set("n", "<leader>ff", "<cmd>Telescope find_files<cr>", { desc = "Find Files" })

• <leader><space> - Find files with Telescope
• <leader>ff - Find files (alternative)

Default Leader Key

LazyVim uses <space> as the leader key by default.

Plugin Configuration

Catppuccin Theme

The Catppuccin theme is configured with extensive integrations:

return {
  "catppuccin/nvim",
  lazy = true,
  name = "catppuccin",
  opts = {
    lsp_styles = {
      underlines = {
        errors = { "undercurl" },
        hints = { "undercurl" },
        warnings = { "undercurl" },
        information = { "undercurl" },
      },
    },
    integrations = {
      aerial = true,
      cmp = true,
      dashboard = true,
      flash = true,
      gitsigns = true,
      illuminate = true,
      indent_blankline = { enabled = true },
      lsp_trouble = true,
      mason = true,
      neotree = true,
      noice = true,
      telescope = true,
      treesitter_context = true,
      which_key = true,
      -- ... and more
    },
  },
}

Core Plugins

Colorscheme is set to Catppuccin:

return {
  {
    "LazyVim/LazyVim",
    opts = {
      colorscheme = "catppuccin",
    },
  },
}

Telescope Configuration

Telescope is configured to find hidden files:

{
  "nvim-telescope/telescope.nvim",
  opts = {
    defaults = {
      find_command = { "fd", "--type", "f", "--hidden", "--no-ignore" },
    },
    pickers = {
      find_files = {
        hidden = true,
      },
    },
  },
}

Essential LazyVim Keybindings

File Navigation

Key	Description
<leader>e	Toggle file explorer
<leader><space>	Find files
<leader>ff	Find files (alt)
<leader>fr	Recent files
<leader>fg	Grep in files
<leader>fb	Find buffers

LSP

Key	Description
gd	Go to definition
gr	Go to references
K	Hover documentation
<leader>ca	Code actions
<leader>rn	Rename symbol
[d	Previous diagnostic
]d	Next diagnostic

Editing

Key	Description
<leader>w	Save file
<leader>q	Quit
gcc	Toggle line comment
gc	Toggle comment (visual)
<C-/>	Toggle terminal

Windows

Key	Description
<C-h>	Move to left window
<C-j>	Move to bottom window
<C-k>	Move to top window
<C-l>	Move to right window
<C-Up>	Increase window height
<C-Down>	Decrease window height

Installing Plugins

Add new plugins by creating files in lua/plugins/:

-- lua/plugins/example.lua
return {
  "github/user/plugin-name",
  opts = {
    -- plugin configuration
  },
}

Lazy.nvim will automatically load all files in the plugins directory.

Managing Plugins

• :Lazy - Open plugin manager UI
• :Lazy update - Update all plugins
• :Lazy sync - Install/update/clean plugins
• :Lazy clean - Remove unused plugins

LSP Management

LazyVim uses Mason for LSP server management:

• :Mason - Open Mason UI
• :MasonInstall <server> - Install LSP server
• :LspInfo - Show LSP status

Code Formatting

Formatting is handled by conform.nvim (included in LazyVim):

• <leader>cf - Format current buffer
• Auto-formatting on save (configurable)

FAQ

How do I change the colorscheme?

Edit lua/plugins/core.lua:

opts = {
  colorscheme = "tokyonight",  -- or any installed theme
},

How do I disable a default plugin?

Create a plugin spec with enabled = false:

-- lua/plugins/disable.lua
return {
  { "plugin/name", enabled = false },
}

Where are LazyVim default configs?

LazyVim defaults are documented at:

• Options
• Keymaps
• Autocmds

How do I add a language server?

Use Mason to install:

:Mason

Search for your language server and press i to install. LazyVim will auto-configure most servers.

How do I override LazyVim keymaps?

Add your keymaps to lua/config/keymaps.lua. They will override defaults:

vim.keymap.set("n", "<leader>e", "<cmd>YourCommand<cr>")

Stylua Configuration

Lua code formatting is configured via stylua.toml:

column_width = 120
indent_type = "Spaces"
indent_width = 2

Related Resources

• LazyVim Documentation
• Lazy.nvim Plugin Manager
• Catppuccin Theme
• See Fish Shell for terminal configuration
• See Tmux for terminal multiplexer