███╗   ██╗███████╗ ██████╗    ███████╗██████╗
        ████╗  ██║██╔════╝██╔═══██╗   ██╔════╝██╔══██╗
        ██╔██╗ ██║█████╗  ██║   ██║   █████╗  ██║  ██║
        ██║╚██╗██║██╔══╝  ██║   ██║   ██╔══╝  ██║  ██║
        ██║ ╚████║███████╗╚██████╔╝██╗███████╗██████╔╝
        ╚═╝  ╚═══╝╚══════╝ ╚═════╝ ╚═╝╚══════╝╚═════╝

A modern, LazyVim-based Neovim configuration optimized for web development, AI-assisted coding, and multi-language support.

• LazyVim Foundation: Built on LazyVim for a solid, well-maintained base
• AI Integration: Claude Code, Codeium, and Supermaven support
• Multi-Language: Go, Python, TypeScript, PHP/Laravel, Rust, and more
• Hybrid Formatting: Biome-first with Prettier fallback
• Custom Theme: Eldritch colorscheme with custom lualine statusline
• Modern UI: Snacks.nvim for explorer, picker, dashboard, and terminal

1. Quick Start
2. Architecture
3. Plugin Categories
4. Keybindings Reference
5. Language Support
6. Configuration Guide
7. Workflows

• Neovim >= 0.10.0
• Git
• A Nerd Font (for icons)
• Node.js (for LSP servers)
• Ripgrep (for search)

This configuration is part of a dotfiles repository managed with GNU Stow:

# Clone the dotfiles repository
git clone https://github.com/yourusername/dotfiles ~/.dotfiles

# Stow the nvim package
cd ~/.dotfiles
make stow pkg=nvim

# Or manually
stow -v nvim

1. Open Neovim: nvim
2. Lazy.nvim will automatically install all plugins
3. Run :Mason to install LSP servers and formatters
4. Run :LazyExtras to enable additional language packs

lua/
├── config/              # Core configuration
│   ├── lazy.lua        # Plugin manager bootstrap
│   ├── options.lua     # Vim options
│   ├── keymaps.lua     # Custom keybindings
│   ├── autocmds.lua    # Autocommands
│   └── filetypes.lua   # Custom filetype associations
│
└── plugins/             # Plugin configurations
    ├── disabled.lua    # Disabled plugins (neo-tree)
    │
    ├── ai/             # AI assistants
    │   ├── claudecode.lua
    │   ├── opencode.lua
    │   └── windsurf.lua
    │
    ├── coding/         # Code editing
    │   ├── emmet.lua
    │   └── surround.lua
    │
    ├── editor/         # Editor enhancements
    │   ├── git.lua
    │   ├── ghostty.lua
    │   └── multicursor.lua
    │
    ├── formatting/     # Code formatters
    │   └── prettier.lua
    │
    ├── linting/        # Linters
    │   └── biome.lua
    │
    ├── languages/      # Language-specific configs
    │   ├── go.lua
    │   ├── python.lua
    │   ├── typescript.lua
    │   ├── php.lua
    │   ├── laravel.lua
    │   ├── astro.lua
    │   ├── docker.lua
    │   ├── jinja.lua
    │   ├── mdx.lua
    │   ├── tailwind.lua
    │   └── intelephense.lua
    │
    ├── ui/             # UI customization
    │   ├── colorscheme.lua
    │   ├── eldritch.lua
    │   ├── lualine.lua
    │   ├── treesitter-context.lua
    │   └── lualine/
    │       ├── neoed.lua      # Theme adapter
    │       ├── eldritch.lua   # Eldritch theme
    │       └── rose-pine.lua  # Rose Pine theme
    │
    └── utils/          # Utilities
        └── snacks.lua

1. init.lua - Entry point, loads config.lazy
2. config/lazy.lua - Bootstraps lazy.nvim, loads filetypes
3. LazyVim base plugins load
4. Custom plugin specs load (in directory import order)
5. config/options.lua - Vim options
6. config/keymaps.lua - Keybindings (VeryLazy)
7. config/autocmds.lua - Autocommands (VeryLazy)

Claude Code Configuration (lua/plugins/ai/claudecode.lua):

• Floating window (80% width/height)
• Rounded border
• --dangerously-skip-permissions mode enabled

Formatter Priority (from lua/plugins/formatting/prettier.lua):

1. Biome (primary for JS/TS/JSON/CSS)
2. Prettier (fallback for Biome-supported, primary for HTML/MD)
3. yamlfmt (YAML files)

See CHEATSHEET.md for the complete keybindings reference.

From lazyvim.json:

AI:

• ai.claudecode - Claude Code integration
• ai.codeium - AI completion

Coding:

• coding.mini-surround - Surround text objects
• dap.core - Debug adapter protocol

Editor:

• editor.harpoon2 - Quick file navigation
• editor.mini-files - File browser
• editor.snacks_explorer - Snacks file explorer
• editor.snacks_picker - Snacks picker

Formatting:

• formatting.biome - Biome formatter/linter

Languages:

• lang.angular - Angular
• lang.astro - Astro
• lang.docker - Docker/Compose
• lang.elixir - Elixir
• lang.go - Go
• lang.helm - Helm charts
• lang.json - JSON
• lang.markdown - Markdown
• lang.php - PHP
• lang.python - Python
• lang.rust - Rust
• lang.svelte - Svelte
• lang.tailwind - Tailwind CSS
• lang.terraform - Terraform
• lang.toml - TOML
• lang.typescript - TypeScript
• lang.vue - Vue
• lang.yaml - YAML

Utilities:

• util.dot - Dotfile support
• util.mini-hipatterns - Pattern highlighting

LSP: gopls with enhanced settings

• gofumpt formatting
• Inlay hints (parameters, types, values)
• Static analysis (nilness, unused params/writes)
• Semantic tokens

Testing: neotest-golang

LSP: Pyright + Ruff

• Pyright for type checking
• Ruff for linting (replaces ESLint behavior)

DAP: debugpy integration

Virtual Environments: venv-selector.nvim

LSP: vtsls (not tsserver)

• Complete function calls
• Auto-update imports on file move
• Inlay hints
• Move to file refactoring

DAP: js-debug-adapter

Custom Icons: eslintrc, package.json, tsconfig, etc.

LSP: Intelephense

• Blade template support
• Large file support (5MB)

Tools: PHPStan, Pint, blade-formatter

DAP: php-debug-adapter

Plugin: adalessa/laravel.nvim

• Artisan commands
• Route navigation
• Make generators
• View finder

-- UI
opt.cursorline = true       -- Highlight current line
opt.cursorcolumn = true     -- Highlight current column
opt.scrolloff = 999         -- Keep cursor centered
opt.wrap = true             -- Wrap long lines

-- Files
opt.swapfile = false        -- No swap files
opt.backup = false          -- No backup files
opt.undofile = true         -- Persistent undo

-- Timing
o.timeoutlen = 250          -- Key sequence timeout

-- Platform
g.codeium_arch = "arm64"
g.codeium_os = "Darwin"

1. YAML Frontmatter: Enables YAML syntax in template files
2. Help Windows: Opens help in vertical split
3. Auto Resize: Equalizes splits on window resize
4. No Auto Comment: Disables automatic comment continuation
5. Dotenv Syntax: Highlights .env files as dosini

Colorscheme: Eldritch (lua/plugins/ui/eldritch.lua)

• Transparent: false
• Dim inactive: true
• Dark sidebars and floats
• Custom background: #171928

Statusline: Custom lualine theme (lua/plugins/ui/lualine/neoed.lua)

• Centered filename
• Mode indicator (left and right)
• Project directory
• Git branch and diff
• Diagnostics
• Macro recording indicator

1. Start Neovim - Dashboard shows recent files, dotfiles shortcuts
2. Open Project - Use <leader>ff for file picker
3. Navigate Files - Use Snacks explorer (right sidebar)
4. Edit with Multi-Cursor - <C-n> for next match
5. Format on Save - Biome/Prettier automatically formats

1. Open Lazygit: <leader>gg
2. View inline blame (automatic via gitsigns)
3. Stage changes in Lazygit
4. Commit with conventional messages

1. Set breakpoints
2. Start debug session with language-specific commands
3. Use DAP UI for inspection

1. Toggle Claude Code: <C-A-S-c>
2. Floating window appears (80% size)
3. Ask questions or request code changes
4. Claude Code can read/modify files directly

1. Open Laravel picker: <leader>LL
2. Run Artisan commands: <leader>La
3. Navigate routes: <leader>Lr
4. Generate code: <leader>Lm

:Lazy          " Open plugin manager
:Lazy sync     " Sync plugins
:Lazy health   " Check plugin health

:LspInfo       " Check LSP status
:LspLog        " View LSP logs
:Mason         " Manage LSP servers

:LazyProfile   " Profile startup time

:source %      " Reload current file
" Or restart Neovim

Part of the dotfiles repository. See main repository for license information.

Generated documentation for NOE.ED Neovim configuration