---

name: nvim-plugin-integration description: Add or debug neovim plugins with lazy.nvim

Nvim Plugin Integration

Add, configure, or debug neovim plugins using lazy.nvim.

Config Structure

Adding a Plugin

Simple plugins → add to nvim/lua/plugins/plugins.lua:

Copy{ "author/plugin-name", ft = "filetype", opts = {} }

Complex plugins → create nvim/lua/plugins/<name>.lua:

Copyreturn {
  "author/plugin-name",
  ft = "filetype",        -- lazy load on filetype
  event = "BufReadPost",  -- or lazy load on event
  opts = {},
  config = function(_, opts)
    require("plugin-name").setup(opts)
  end,
}

Update docs/nvim.md with new keymaps.

Debugging

E2E Testing

See nvim-remote-api-testing.md for headless testing.