neovim-config/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Overview

This is a personal Neovim configuration built on lazy.nvim with a focus on LSP, testing, and modern plugin management. The configuration emphasizes a clean, modular structure with separate plugin files.

Architecture

Core Structure

• init.lua: Entry point that sets up vim options, loads lazy.nvim, and initializes core modules
• lua/keybinds.lua: Global keybindings (ALT navigation, terminal toggle, C# namespace helper)
• lua/diagnostic.lua: Diagnostic display configuration with custom signs and virtual text
• lua/snippets.lua: LuaSnip snippets (currently contains C# namespace/class generation)
• lua/plugins/: Modular plugin configurations, each file returns a lazy.nvim plugin spec

Plugin Architecture Pattern

Each plugin file follows lazy.nvim's structure:

return {
  'author/plugin-name',
  dependencies = { ... },
  opts = { ... },
  config = function() ... end,
}

Key Plugins & Configuration

LSP (lua/plugins/lsp.lua)

• Uses mason.nvim with custom registry including Crashdummyy's registry
• Configured servers: lua_ls, vtsls, jsonls (with schemastore), bashls, zls, cssls, prismals, intelephense, html, yamlls, eslint, tailwindcss, gopls, rust_analyzer, roslyn
• Auto-installs tools: stylua, prettierd, php-cs-fixer, cspell
• Blink.cmp integration for completion capabilities
• Keybindings set on LspAttach:
  • <leader>a: Code actions
  • gd, gr, gi: Definition/references/implementation via Telescope
  • <f2>: Rename
  • <leader>d: Show diagnostics float
  • <leader>D: Jump to next diagnostic

Formatting (lua/plugins/conform.lua)

• Format-on-save enabled (3s timeout)
• Formatters: stylua (Lua), prettierd/prettier (JS/TS/CSS/JSON/Markdown), php-cs-fixer (PHP), gofmt (Go), csharpierd (C#)
• Manual format: <leader>f

Testing (lua/plugins/neotest.lua)

• Adapters: neotest-jest, neotest-bun
• Jest config auto-detection from project root
• Keybindings:
  • <leader>tt: Run nearest test
  • <leader>tf: Run all tests in current file
  • <leader>td: Display test output

Fuzzy Finding (lua/plugins/telescope.lua)

• Keybindings (all start with <leader>f):
  • ff: Find files
  • fg: Live grep
  • fb: Buffers
  • fd: Diagnostics
  • fw: Grep string under cursor
  • fh/fk/fs/fr/f.: Help/keymaps/builtin/resume/oldfiles
  • ft: Todo comments

C# Development

• Roslyn LSP configured
• Custom namespace insertion: <leader>n (reads .csproj, constructs namespace from path)
• C# class snippet: csc (auto-generates namespace and class from filename)
• csharpierd formatter integration

Development Workflow

Testing JavaScript/TypeScript

# Run nearest test (with cursor on test)
<leader>tt

# Run all tests in file
<leader>tf

# View test output
<leader>td

Formatting

• Auto-formats on save (configured in conform.lua)
• Manual format: <leader>f

LSP Operations

• Jump to definition: gd (opens in Telescope)
• Find references: gr (opens in Telescope)
• Rename symbol: <F2>
• Code actions: <leader>a
• Show diagnostics: <leader>d
• Next diagnostic: <leader>D
• Workspace symbols: <leader>fs

Special Configurations

Clipboard

Uses xclip for clipboard integration on Linux (configured in init.lua with vim.schedule)

Theme

TokyoNight theme with transparency disabled on WSL, terminal colors disabled

Tab Behavior

2-space indentation, tabs converted to spaces globally

Window Navigation

• ALT + Arrow keys to navigate between splits
• <C-p> mapped to <C-i> for jump forward

Terminal

• <leader><CR>: Open terminal in insert mode
• <Esc>: Exit terminal mode to normal mode

Plugin Management

Installing/Updating Plugins

Lazy.nvim auto-bootstraps on first run. To manage plugins:

• Add new plugin specs to lua/plugins/ or directly in init.lua's require('lazy').setup()
• Lazy will auto-install on next startup

Mason Tool Management

LSP servers and formatters are auto-installed via mason-tool-installer based on the ensure_installed list in lua/plugins/lsp.lua

Important Notes

• Leader key is Space
• Nerd Font required (vim.g.have_nerd_font = true)
• Swap and backup files disabled
• Relative line numbers enabled
• 10-line scrolloff for cursor positioning
• The configuration uses Neovim 0.10+ APIs with compatibility shim for 0.11 (see client_supports_method in lsp.lua)