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

My personal Neovim configuration, based on LazyVim - optimized for web development and used as my ADE (AI/Agent Development Environment) of choice.

• E.DOTS - Dotfiles
• E.Defy - Dygma Defy keyboard

• LazyVim Foundation: Built on LazyVim for a solid, well-maintained base
• AI Integration: opencode and Claude Code with Codeium and Supermaven for text completion
• Multi-Language: JavaScript/TypeScript, Go, Python, PHP/WordPress, Rust, and more
• Hybrid Formatting: Biome-first with Prettier fallback
• Custom Theme: Eldritch colorscheme with custom lualine statusline

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 my Dotfiles repo managed with GNU Stow:

# Clone the dotfiles repository
git clone https://github.com/edheltzel/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           # PHP/WordPress (phpactor)
    │   ├── astro.lua
    │   ├── docker.lua
    │   ├── jinja.lua
    │   ├── mdx.lua
    │   ├── tailwind.lua
    │   └── ghostty.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)

opencode Configuration (lua/plugins/ai/opencode.lua):

• Floating window (80% width/height)
• Rounded border
• YOLO or dangerously-skip-permissions is enabled by default with opencod

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: phpactor

• Blade template support
• WordPress development optimized
• Diagnostics disabled (no "function not found" errors)

Formatter: phpcbf with WordPress coding standards

DAP: php-debug-adapter

WordPress Setup: For WordPress projects, add php-stubs/wordpress-stubs via Composer and create a .phpactor.json:

{
  "php_code_sniffer.enabled": false,
  "language_server_worse_reflection.diagnostics.enable": false,
  "indexer.stub_paths": ["%project_root%/vendor/php-stubs/wordpress-stubs"]
}

-- 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

: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.