lua-nvim/lua/cargdev/core/keymaps

Keymaps Structure

This folder contains all the keymaps organized by category for better maintainability.

File Structure

keymaps/
├── README.md          # This file
├── general.lua        # General keymaps (leader, basic navigation, obsidian)
├── personal.lua       # Personal workflow keymaps
├── lsp.lua            # LSP and function navigation keymaps
├── dap.lua            # DAP debugging keymaps
├── snacks.lua         # Snacks search and navigation keymaps
├── window.lua         # Window management keymaps
├── copilot.lua        # Copilot AI keymaps
├── plugins.lua        # Plugin-specific keymaps (Telescope, trouble, etc.)
├── project.lua        # Project-specific keymaps
├── ufo.lua            # Folding keymaps
├── leet.lua           # LeetCode keymaps
├── sudoku.lua         # Sudoku game keymaps
└── database.lua       # Database keymaps

How It Works

The main keymaps.lua file automatically loads all .lua files from this folder:

local function load_keymaps()
  local keymaps_path = vim.fn.stdpath("config") .. "/lua/cargdev/core/keymaps"
  local scan = vim.fn.globpath(keymaps_path, "*.lua", false, true)

  for _, file in ipairs(scan) do
    local module_name = "cargdev.core.keymaps." .. file:match("([^/]+)%.lua$")
    pcall(require, module_name)
  end
end

Keymap Categories

Category	File	Description
General	general.lua	Basic setup, escape, obsidian links
Personal	personal.lua	Your workflow shortcuts
LSP	lsp.lua	Function navigation and LSP features
Debugging	dap.lua	DAP debugging (Java, Node.js, Python)
Search	snacks.lua	File and text search (Snacks)
Window	window.lua	Window/split management
Copilot	copilot.lua	AI assistant keymaps
Plugins	plugins.lua	Plugin-specific (Telescope, trouble, etc.)
Project	project.lua	Project commands
Folding	ufo.lua	Code folding
LeetCode	leet.lua	LeetCode integration
Database	database.lua	Database operations

Adding New Keymaps

1. Choose the appropriate file based on the category
2. Add your keymaps using the standard format:

   local keymap = vim.keymap
   keymap.set("n", "<leader>key", "<cmd>command<cr>", { desc = "Description" })
   

3. The keymaps will be automatically loaded when Neovim starts

Leader Key Prefixes

Prefix	Category
<leader>f	Find/Files (Telescope)
<leader>g	Git
<leader>d	Debug
<leader>l	LSP/LeetCode
<leader>x	Trouble/Diagnostics
<leader>s	Search/Session
<leader>t	Toggle/Text/Treesj
<leader>h	Harpoon
<leader>k	Kulala (HTTP)
<leader>o	Overseer/Octo
<leader>n	NPM/Navbuddy
<leader>c	Code/Crates
<leader>v	Vim learning
<leader>z	Zen mode
<leader>q	Session (persistence)
<leader>r	Rename/Regex
<leader>p	Portal/Projects

Full Reference

See KEYMAPS.md in the root directory for complete keybinding reference.

Notes

• All files are automatically loaded by keymaps.lua
• Each file should have its own local keymap = vim.keymap declaration
• Use descriptive desc for all keymaps (shows in which-key)
• Follow the existing naming conventions for consistency