🚀 Personal Neovim Configuration

A modern, feature-rich Neovim setup built for productivity and development workflow optimization.

📊 Config Stats: 54 plugins • 3 core configs • 9 file templates

✨ Key Features

🔧 Development Tools

• Language Server Protocol (LSP) - Full IDE-like features with auto-completion, diagnostics, and code actions
• Debug Adapter Protocol (DAP) - Integrated debugging support for multiple languages
• Tree-sitter - Advanced syntax highlighting and code understanding
• Auto-formatting - Code formatting with conform.nvim and language-specific tools
• Linting - Real-time code analysis and error detection

🎨 User Interface

• Catppuccin Theme - Beautiful, eye-friendly color scheme
• Enhanced UI - Custom statusline, bufferline, and floating windows
• File Explorer - Feature-rich nvim-tree with git integration
• Fuzzy Finding - Telescope for lightning-fast file and content search

⚡ Productivity

• Git Integration - Full git workflow with lazygit, gitsigns, and fugitive
• Terminal Integration - Seamless terminal and tmux navigation
• Session Management - Project-aware sessions and workspace restoration
• Snippet System - Extensive snippet collection for faster coding

🧪 Testing & Quality

• Neotest - Integrated test runner with language-specific adapters
• Code Coverage - Visual coverage indicators
• Pre-commit Hooks - Automated code quality checks and documentation generation

🛠️ Installation

Prerequisites

• Neovim 0.10.0+ or later
• Git for plugin management
• Node.js for LSP servers
• Python and pip for additional tools
• Ripgrep for fast searching
• A Nerd Font for icons

Quick Setup

# Backup existing config (optional)
mv ~/.config/nvim ~/.config/nvim.backup

# Clone this configuration
git clone https://github.com/remoterabbit/nvim.git ~/.config/nvim

# Start Neovim (plugins will auto-install)
nvim

📂 Structure

~/.config/nvim/
├── 📁 lua/
│   ├── 📁 config/          # Core configuration
│   │   ├── options.lua     # Neovim options
│   │   ├── keymaps.lua     # Global keymaps
│   │   └── lazy.lua        # Plugin manager setup
│   └── 📁 plugins/         # Plugin configurations
├── 📁 docs/                # Auto-generated documentation
│   ├── KEYBINDINGS.md      # Comprehensive keybinding reference
│   └── PLUGINS.md          # Detailed plugin documentation
├── 📁 scripts/             # Automation scripts
├── 📁 templates/           # File templates
├── init.lua               # Entry point
└── stylua.toml           # Code formatting config

📚 Documentation

• Keybindings Reference - Complete list of all keybindings organized by mode
• Plugin Documentation - Detailed information about each plugin
• Contributing Guidelines - How to contribute to this configuration

⌨️ Key Mappings

Leader Key: <space>

Category	Key	Description
Files	<leader>ff	Find files
Search	<leader>fg	Live grep
Git	<leader>gg	LazyGit
LSP	<leader>ca	Code actions
Debug	<leader>dt	Toggle breakpoint

💡 Tip: Press <space> in normal mode to see all available keybindings with which-key.

🔧 Customization

Adding New Plugins

1. Create a new file in lua/plugins/
2. Follow the existing plugin structure
3. Run :Lazy to manage plugins

Language Support

This configuration includes LSP support for:

• Python (Pyright)
• JavaScript/TypeScript (ts_ls)
• Lua (lua_ls)
• Go (gopls)
• Rust (rust-analyzer)
• And many more...

🤝 Contributing

Found a bug or want to add a feature? Contributions are welcome!

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run pre-commit hooks: pre-commit run --all-files
5. Submit a pull request

📄 License

This configuration is released into the public domain under the Unlicense.

---

⭐ Star this repo if you find it useful!

Installed Plugins (72 total)

🔧 Language & LSP

• neovim/nvim-lspconfig
• onsails/lspkind.nvim
• ray-x/lsp_signature.nvim
• williamboman/mason-lspconfig.nvim
• williamboman/mason.nvim

🎨 UI & Themes

• akinsho/bufferline.nvim
• catppuccin/nvim
• nvim-lualine/lualine.nvim
• norcalli/nvim-colorizer.lua
• kristijanhusak/vim-dadbod-ui

🔍 Navigation & Search

• nvim-treesitter/nvim-treesitter
• nvim-treesitter/nvim-treesitter-textobjects
• nvim-telescope/telescope.nvim
• cappyzawa/telescope-terraform.nvim
• mbbill/undotree

💡 Completion

• saghen/blink.cmp

✏️ Editing

• numToStr/Comment.nvim
• windwp/nvim-autopairs
• kylechui/nvim-surround
• folke/todo-comments.nvim

📝 Git Integration

• harrisoncramer/gitlab.nvim
• lewis6991/gitsigns.nvim

🐛 Testing & Debugging

• nvim-neotest/neotest
• mfussenegger/nvim-dap
• mfussenegger/nvim-dap-python

💻 Terminal

• christoomey/vim-tmux-navigator

🔌 Other Plugins

• stevearc/aerial.nvim
• laytan/cloak.nvim
• stevearc/conform.nvim
• sindrets/diffview.nvim
• elixir-tools/elixir-tools.nvim
• allaman/emoji.nvim
• j-hui/fidget.nvim
• ray-x/go.nvim
• ThePrimeagen/harpoon
• mistweaverco/kulala.nvim
• L3MON4D3/LuaSnip
• karb94/neoscroll.nvim
• saxon1964/neovim-tips
• andythigpen/nvim-coverage
• warpaint9299/nvim-devdocs
• gennaro-tedesco/nvim-jqx
• mfussenegger/nvim-lint
• paretje/nvim-man
• SmiteshP/nvim-navic
• michaelrommel/nvim-silicon
• kevinhwang91/nvim-ufo
• nvim-tree/nvim-web-devicons
• epwalsh/obsidian.nvim
• pwntester/octo.nvim
• hedyhli/outline.nvim
• stevearc/overseer.nvim
• vuki656/package-info.nvim
• nvim-lua/plenary.nvim
• stevearc/profile.nvim
• ThePrimeagen/refactoring.nvim
• MeanderingProgrammer/render-markdown.nvim
• b0o/schemastore.nvim
• LintaoAmons/scratch.nvim
• m4xshen/smartcolumn.nvim
• mrjones2014/smart-splits.nvim
• folke/snacks.nvim
• nvim-pack/nvim-spectre
• nvim-lua/plenary.nvim
• nvim-telescope/telescope.nvim
• folke/trouble.nvim
• linux-cultist/venv-selector.nvim
• RRethy/vim-illuminate
• dhruvasagar/vim-table-mode
• wakatime/vim-wakatime
• folke/which-key.nvim