nvim

Stow package for ~/.config/nvim/. A from-scratch Lua config (lazy.nvim + native LSP + Treesitter), not a port of ~/.vimrc. The older vim/ package stays as-is and remains the default $EDITOR; this exists to migrate to Neovim incrementally without losing the muscle memory baked into the Vim config.

Table of contents

• Layout
• Plugin map (Vim → Neovim)
• What Neovim made redundant
• LSP, completion, linting
• Leader-key cheat sheet
• Text objects (Treesitter)
• Go workflow
• Settings that differ from the .vimrc
• Runtime directories
• Fresh-machine setup

Leader is , (vim.g.mapleader = ','), set in init.lua before any plugin loads.

Layout

nvim/.config/nvim/
├── init.lua                 entry: leader, then require the config modules
└── lua/
    ├── config/
    │   ├── lazy.lua         bootstrap lazy.nvim, import lua/plugins/
    │   ├── options.lua      vim.opt settings ported from .vimrc
    │   ├── keymaps.lua      non-plugin maps (leader, visual-line j/k, …)
    │   ├── autocmds.lua     trailing-WS, cursor restore, text tw=80
    │   └── commands.lua     :W (SudoWrite alias), :DiffOrig
    └── plugins/             one spec file per concern; lazy imports them all
        ├── colorscheme.lua  dracula.nvim
        ├── editing.lua      tpope stack, autopairs, tmux-navigator
        ├── ui.lua           lualine, nvim-tree, aerial, undotree
        ├── finder.lua       fzf-lua
        ├── git.lua          fugitive, gitsigns
        ├── treesitter.lua   nvim-treesitter
        ├── completion.lua   blink.cmp + friendly-snippets
        ├── lsp.lua          mason, lspconfig, nvim-lint
        └── lang.lua         go.nvim, rust.vim

init.lua is Neovim’s $MYVIMRC, so ,ev / ,sv edit / source it.

Plugin map (Vim → Neovim)

Kept as-is — these run natively and have no better replacement: vim-surround, vim-repeat, vim-sleuth, vim-eunuch, vim-projectionist, vim-dispatch, vim-fugitive, splitjoin.vim, vim-tmux-navigator, undotree, rust.vim.

Replaced with a Lua-native equivalent:

What Neovim made redundant

Dropped entirely — the capability is now built in:

LSP, completion, linting

• Servers (auto-installed by mason-lspconfig): gopls (via go.nvim), rust_analyzer, pyright, lua_ls, bashls, yamlls. Enabled with the native vim.lsp.enable(); :Mason manages the binaries.
• Built-in LSP maps (Neovim defaults, on attach): K hover, grr references, grn rename, gra code action, gri implementation, [d/]d diagnostics. Added on top: gd definition, ,e rename, ,ca code action.
• Completion: blink.cmp — <C-y> accept, <C-n>/<C-p> select, <C-space> toggle docs. Snippets come from friendly-snippets.
• Format on save: Go uses go.nvim’s goimports; every other server that advertises formatting (rust_analyzer, lua_ls) runs vim.lsp.buf.format() on BufWritePre (built-in, no plugin). Servers that can’t format (pyright, bashls, yamlls) are simply skipped.
• Linting: nvim-lint runs the same linters ALE did — pylint (Python), shellcheck (sh), yamllint (yaml). The CLI tools must be on PATH.

Leader-key cheat sheet

(Leader = ,. Maps shared with the Vim config keep the same keys.)

Non-leader maps carried over verbatim from the .vimrc: jj→Esc, visual-line j/k, <M-j>/<M-k> move line/selection, < / > keep selection, <Tab>→%, recentering n/N/*/#, very-magic /, Q→gq, <C-h/j/k/l> window+tmux navigation. See the vim README for the rationale behind each.

Text objects (Treesitter)

From nvim-treesitter-textobjects (no built-in equivalent). Use in operator- or visual-pending position, e.g. daf deletes a whole function, vif selects its body, cia changes an argument:

Go workflow

go.nvim owns gopls and reproduces the vim-go commands. Maps active only in .go buffers:

go.nvim drives gopls (already on $PATH if you used vim-go — it installs to ~/go/bin). The extra tools it shells out to (gotests, iferr, …) come from :GoInstallBinaries — run it from inside a Go buffer, since go.nvim only loads for Go filetypes; nvim "+GoInstallBinaries" on an empty buffer fails with “not an editor command”. goimports runs on save.

Settings that differ from the .vimrc

Mostly faithful; the deliberate changes:

Everything else — colorcolumn 80+120 formula, clipboard, undofile, textwidth=200 (80 for text), ignorecase+smartcase, gdefault, trailing-whitespace highlight + strip-on-save for go/py/sh — is ported directly.

Runtime directories

init.lua/options.lua create these on startup (Neovim won’t):

~/.config/nvim/lazy-lock.json pins plugin commits — commit it after a :Lazy sync so installs are reproducible.

Fresh-machine setup

stow nvim                                   # symlinks ~/.config/nvim
nvim --headless "+Lazy! sync" +qa           # install plugins

Then, for the optional Go tools, open any .go file and run :GoInstallBinaries (gopls itself is already covered if vim-go installed it).

Treesitter compiles parsers on first run (needs a C compiler — clang on macOS, build-essential on Debian). :checkhealth flags anything missing.