Neovim Configuration

Minimal Neovim 0.12 config for web development (TypeScript, React, Tailwind) and Python. Uses native LSP completion and lazy.nvim for plugin management.

Requirements

• Neovim >= 0.12
• Node.js + ripgrep + lazygit
• A Nerd Font

Structure

lua/
├── config/
│   ├── options.lua        # Editor options
│   ├── keymaps.lua        # Global keybindings
│   └── lazy.lua           # Plugin manager bootstrap
└── plugins/               # One file per plugin
    ├── lsp.lua            # Mason + LSP + native completion
    ├── telescope.lua      # Fuzzy finder
    ├── treesitter.lua     # Syntax highlighting
    ├── formatting.lua     # conform.nvim (Biome/Prettier/ruff)
    ├── gitsigns.lua       # Git hunks
    ├── lazygit.lua        # LazyGit integration
    ├── oil.lua            # File explorer
    ├── surround.lua       # Text surrounds
    ├── autopairs.lua      # Auto brackets
    ├── ts-autotag.lua     # Auto HTML tags
    ├── ts-error-translator.lua # Human-readable TS errors
    ├── todo-comments.lua  # TODO highlighting
    ├── which-key.lua      # Keymap groups
    ├── lualine.lua        # Status line
    ├── colorscheme.lua    # catppuccin-macchiato
    └── markdown-preview.lua

Keybindings

Leader: <Space>. Press <leader> and wait to see all groups via which-key.

General

Key	Action
<Esc>	Clear search
<leader>w / <leader>q	Save / Quit
<C-h/j/k/l>	Navigate windows
J / K (visual)	Move lines
jj	Exit insert mode

Buscar (Telescope)

Key	Action
<leader>ff	Find files
<leader>fg	Live grep
<leader>fb	Buffers
<leader>fh	Help tags
<leader>fr	Recent files
<leader>fG	Git status
<leader>ft	Search TODOs

Git

Key	Action
<leader>lg	LazyGit
<leader>gj / <leader>gk	Next / prev hunk
<leader>gs	Stage hunk
<leader>gr	Reset hunk
<leader>gp	Preview hunk
<leader>gb	Blame line
<leader>gd	Diff

Code (LSP — native defaults)

Key	Action
gd	Go to definition
grr	References
grn	Rename
gra	Code action
grt	Type definition
grx	Codelens run
gri	Implementation
gO	Document symbols
K	Hover docs
<leader>cf	Format file
[d / ]d	Prev / next diagnostic
]t / [t	Next / prev TODO

Completion (native Neovim 0.12)

Key	Action
<C-n> / <C-p>	Next / prev item
<C-y>	Confirm selection
<C-e>	Dismiss

File Explorer

Key	Action
-	Open directory (Oil)
<leader>-	Project root

LSP Servers

Auto-installed via Mason: ts_ls, tailwindcss, eslint, jsonls, pyright, ruff

Formatters

Format on save via conform.nvim:

• JS/TS/React: Biome > Prettier > ESLint (first available)
• JSON: Biome > Prettier
• HTML/CSS/Markdown: Prettier
• Python: ruff_format + ruff_fix