NvData — Opinionated Neovim for Data‑Centric Devs

A lightweight fork of NvChad tuned for Rust, TypeScript, YAML and day‑to‑day data engineering. Grab it from: GitHub

---

✨ Feature Highlights

Area	Goodies
Language Servers	rust_analyzer, ts_ls, yamlls, pyright, lua_ls, html, cssls
Formatting / Linting	conform.nvim – optional format‑on‑save
Completion + AI	nvim‑cmp, crates.nvim (Cargo smarts), supermaven completion: Ctrl+y
Claude Code	AI pair programming via claude-code.nvim
Fuzzy Find / Git	Telescope (Leader f f, Leader f g), Neogit, Diffview
Treesitter	Grammar for vim lua yaml rust typescript tsx html css
Package Manager	Mason + mason‑lspconfig → one command for all LSPs & tools
QoL Tweaks	Inlay hints auto‑enabled, split nav Ctrl‑h/j/k/l, universal Leader q cleanup
Markdown	Preview (Leader m g), Cheatsheet (Leader c h)

---

🚀 Quick Start

# 1. Grab the config
git clone https://github.com/spread-ai/nvdata ~/.config/nvim

# 2. First launch – installs plugins
nvim +'Lazy sync' +qa

# 3. Pull language servers & formatters
nvim +MasonInstallAll +qa

Prereqs: Neovim ≥ 0.9, Git, Node 16+, Rust toolchain.

Recommended extras

# Live‑grep for Telescope
cargo install ripgrep

# Claude Code CLI (for AI pair programming)
npm install -g @anthropic-ai/claude-code

---

🕹 Keymap Cheat‑Sheet

Action	Keys
Leader	Space
File tree toggle	Ctrl‑n
Telescope — Find files / Live grep	Leader f f / f g
Buffer next / prev	Tab / Shift‑Tab
Split nav	Ctrl‑h/j/k/l
Close loclist / quickfix / term	Leader q
Hover diagnostic (full)	K
Diagnostic list	Leader d l
supermaven accept	Ctrl‑y
supermaven clear	Ctrl‑]
supermaven accept word	Ctrl‑j
Cheatsheet popup	Leader c h
markdown preview	Leader m g
Git integration	Leader g g
go to references of symbol under cursor	g r
go to definition of symbol under cursor	g d
format everything using current language	Leader f m
format file with prettier only	Leader f p
Claude Code toggle	Leader c c
Claude Code continue conversation	Leader c C
Claude Code resume (picker)	Leader c r
Claude Code verbose mode	Leader c v

Enable format‑on‑save by uncommenting event = "BufWritePre" in plugins/conform.lua.

---

🖥 Terminal + Fonts (optional)

1. Alacritty

   brew install alacritty
   git clone https://github.com/alacritty/alacritty-theme ~/.config/alacritty/themes

2. Nerd Fonts

   Download SourceCodePro Nerd Font and set it in ~/.config/alacritty/alacritty.toml:

   [general]
   import = ["~/.config/alacritty/themes/themes/tokyo-night.toml"]
   
   [font]
   normal = { family = "SauceCodePro Nerd Font Mono" }

---

🧰 tmux Booster

brew install tmux
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

Minimal ~/.tmux.conf:

set -g mouse on
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
set -g @plugin 'erikw/tmux-powerline'
set -g @plugin 'tmux-plugins/tmux-resurrect'

run '~/.tmux/plugins/tpm/tpm'

Check scripts/tmux-session.sh for a project launcher with editor, auth‑mock, Redis & Neo4j panes.

---

🔄 Updating

cd ~/.config/nvim
git pull
nvim +Lazy\ sync +qa
nvim +MasonUpdate +qa

---

🩹 Troubleshooting

Symptom	Fix
updated_registries nil error on launch	:Lazy sync for patched Mason
LSP not attaching	:MasonInstallAll then :LspInfo
supermaven clashes with Tab	Tab is disabled → use Ctrl‑y

---

License

MIT © 2025 SPREAD