LazyVim Configuration

Repository Context

• Config location:

  editor/nvim/

• Theme: Catppuccin Frappe (consistent with terminal, bat, etc.)
• Focus areas: Data work (dbt, SQL, Python) and Markdown authoring
• Snippets:

  editor/nvim/snippets/

  (friendly-snippets format)

Configuration Files

lua/plugins/*.lua

lua/config/keymaps.lua

lua/config/options.lua

lua/config/autocmds.lua

lazy-lock.json

lazyvim.json

Instructions

Before Making Changes

1. Check LazyVim defaults at https://www.lazyvim.org/ to avoid redundant configuration
2. Read the existing config file before editing
3. Verify the plugin is not already configured by LazyVim extras

Plugin Configuration

-- lua/plugins/example.lua
return {
  -- Extend existing plugin
  {
    "plugin/name",
    opts = {
      -- Options merge with defaults
    },
  },

  -- Override existing plugin
  {
    "plugin/name",
    opts = function(_, opts)
      -- Modify opts table directly
      opts.some_option = "value"
    end,
  },

  -- Add new plugin
  {
    "author/new-plugin",
    event = "VeryLazy",  -- Lazy-load on event
    dependencies = { "nvim-lua/plenary.nvim" },
    opts = {},
    keys = {
      { "<leader>xx", "<cmd>PluginCommand<cr>", desc = "Description" },
    },
  },

  -- Disable a plugin
  { "plugin/to-disable", enabled = false },
}

Keymap Configuration

-- lua/config/keymaps.lua
local map = vim.keymap.set

-- Format: map(mode, lhs, rhs, opts)
map("n", "<leader>xx", "<cmd>SomeCommand<cr>", { desc = "Description" })
map("v", "<leader>yy", function() ... end, { desc = "Description" })

-- Delete a LazyVim keymap
vim.keymap.del("n", "<leader>existing")

Options Configuration

-- lua/config/options.lua
local opt = vim.opt

opt.relativenumber = false
opt.scrolloff = 8
opt.wrap = true

Autocmds Configuration

-- lua/config/autocmds.lua
vim.api.nvim_create_autocmd("FileType", {
  pattern = { "sql", "python" },
  callback = function()
    vim.opt_local.tabstop = 4
  end,
})

Common Tasks

Add Language Support

1. Check if LazyVim has an "extra" for the language (lazyvim.json)
2. If yes, enable it rather than manual config
3. If no, create

   lua/plugins/lang-<name>.lua

Add Snippets

1. Create JSON file in

   editor/nvim/snippets/<filetype>/<name>.json

2. Follow friendly-snippets format
3. Snippets auto-load for matching filetypes

Debug Configuration Issues

1. Run

   :checkhealth

   in Neovim
2. Check

   :Lazy

   for plugin errors
3. Use

   :verbose map <key>

   to trace keybindings
4. Check

   :messages

   for startup errors

Guidelines

• Prefer LazyVim extras over manual plugin config when available
• Use

  opts

  table merging instead of full override when possible
• Include

  desc

  for all keymaps (appears in which-key)
• Lazy-load plugins with

  event

  ,

  ft

  ,

  cmd

  , or

  keys

• Test changes by restarting Neovim or running

  :Lazy sync

• Check for macOS keybinding conflicts (Mission Control, Spotlight)
• Keep Catppuccin Frappe theme consistent across colorscheme configs

LuaLS Configuration and Warnings

vim

vim

External Resources

• LazyVim Docs: https://www.lazyvim.org/
  • For needs not covered here, refer to LazyVim documentation.