🚀 My Neovim Configuration

⭐ If you find this config helpful, please star the repository! It motivates me to keep improving and adding new features.

A modern, feature-rich Neovim configuration built with Lua and managed by lazy.nvim. Organized, fast, and beautiful - just the way it should be.

📸 Screenshots

Dashboard

Coding Interface

File Explorer

Command Palette

✨ Features

• 🎨 Beautiful UI - Catppuccin theme with optional transparency


• 🎯 Centered Command Palette - Noice.nvim for beautiful cmdline with icons


• 📦 Smart Plugin Management - lazy.nvim with organized structure


• 🔍 Fuzzy Finding - Snacks picker for files, grep, buffers


• 🌳 File Explorer - Snacks explorer (nvim-tree and oil.nvim also available)


• 💡 Full LSP Support - Auto-completion, diagnostics, and formatting


• 🎯 GitHub Copilot - AI-powered code completion


• 🔄 Git Integration - LazyGit integration with diff support


• 📊 Smart Statusline - Shows git status, diagnostics, and "I use Arch btw"


• 🧪 Testing - vim-test integration


• 📝 Markdown & API Preview - Live preview for markdown and Swagger/OpenAPI


• 🐳 Docker Management - LazyDocker integration


• 🎭 Discord Presence - Show what you're coding with cord.nvim


• 🎵 Now Playing - Dashboard shows current song via playerctl


• 🎨 Code Folding - nvim-ufo for smart folding


• ⚡ Fast Startup - Optimized lazy loading (~80ms with 26+ plugins)

📋 Requirements

• Neovim >= 0.9.0


• Git


• A Nerd Font (recommended: JetBrainsMono Nerd Font)


• Node.js (for LSP servers and Copilot)


• Ripgrep (for grep functionality)


• LazyGit (optional, for git integration)


• LazyDocker (optional, for docker management)


• tmux (for splitting tabs)

🚀 Installation

Linux/macOS

# Backup your existing config (if any)

mv ~/.config/nvim ~/.config/nvim.backup



# Clone this repository

git clone https://github.com/MannuVilasara/nvim.git ~/.config/nvim



# Start Neovim

nvim

Lazy.nvim will automatically install all plugins on first launch.

📦 Plugins

Plugins are organized into categories for better maintainability. See STRUCTURE.md for the complete organization guide.

Core

• 
  lazy.nvim - Modern plugin manager


• 
  plenary.nvim - Lua utility functions

UI & Appearance (lua/plugins/ui/)

• 
  catppuccin - Beautiful color scheme with transparency support


• 
  lualine.nvim - Customizable statusline with git, diagnostics, and OS info


• 
  bufferline.nvim - Buffer/tab line with navigation shortcuts


• 
  noice.nvim - Enhanced cmdline with centered popup and icons


• 
  nvim-web-devicons - File icons everywhere


• 
  nvim-colorizer.lua - Live color preview


• 
  dressing.nvim - Better UI for input/select


• 
  fidget.nvim - LSP progress notifications


• 
  snacks.nvim - Dashboard with now playing and utilities

Editor (lua/plugins/editor/)

• 
  nvim-treesitter - Better syntax highlighting and code understanding


• 
  nvim-autopairs - Auto-close brackets and quotes


• 
  comment.nvim - Smart commenting (gcc, gbc)


• 
  which-key.nvim - Keybinding hints popup


• 
  nvim-ufo - Smart code folding with treesitter


• 
  nvim-tree.lua - File explorer sidebar


• 
  oil.nvim - Edit filesystem like a buffer

LSP & Completion (lua/plugins/lsp/)

• 
  nvim-lspconfig - Easy LSP server configurations


• 
  nvim-cmp - Powerful completion engine


• 
  cmp-nvim-lsp - LSP completion source


• 
  cmp-buffer - Buffer word completion


• 
  cmp-path - File path completion


• 
  LuaSnip - Snippet engine


• 
  cmp_luasnip - Snippet completion source


• 
  none-ls.nvim - Formatting and linting


• 
  conform.nvim - Fast code formatter

Tools (lua/plugins/tools/)

• 
  copilot.lua - GitHub Copilot integration


• 
  toggleterm.nvim - Terminal management


• 
  lazydocker.nvim - Docker TUI integration


• 
  vim-test - Test runner


• 
  cord.nvim - Discord Rich Presence


• 
  nvim-tmux-navigation - Seamless tmux/vim navigation


• 
  rails.nvim - Ruby on Rails utilities


• 
  markdown-preview.nvim - Live markdown preview


• 
  swagger-preview.nvim - Swagger/OpenAPI preview

⌨️ Key Bindings

General

• 
  <leader> is set to Space
  

Dashboard (Snacks)

• 
  f - Find File


• 
  n - New File


• 
  g - Find Text (Grep)


• 
  r - Recent Files


• 
  c - Open Config


• 
  L - Lazy Plugin Manager


• 
  q - Quit

Fuzzy Finding

• 
  <C-p> - Find Files


• 
  <leader><leader> - Recent Files


• 
  <leader>fb - Buffers


• 
  <leader>fg - Grep Files


• 
  <leader>p - Command Palette


• 
  <leader>fh - Help Pages


• 
  <leader>fc - Colorschemes


• 
  <leader>fk - Keymaps

File Explorer

• 
  <leader>ee - Toggle Explorer

Buffer Navigation

• 
  Tab - Next Buffer


• 
  Shift+Tab - Previous Buffer


• 
  <leader>bd - Delete Buffer


• 
  <leader>bb - Pick Buffer


• 
  <leader>b1-9 - Go to Buffer 1-9

Git

• 
  <leader>lg - LazyGit


• 
  <leader>gl - LazyGit Log (current file)

Scratch Buffer

• 
  <leader>sf - Toggle Scratch Buffer


• 
  <leader>S - Select Scratch Buffer

Code Folding (UFO)

• 
  zR - Open all folds


• 
  zM - Close all folds


• 
  za - Toggle fold under cursor


• 
  zj - Go to next fold


• 
  zk - Go to previous fold

Fidget Notifications (Demo)

• 
  <leader>na - Info notification


• 
  <leader>nb - Warning notification


• 
  <leader>nc - Notification with annotation


• 
  <leader>np - Progress spinner demo

🎨 Customization

Transparency Toggle

Edit lua/plugins/ui/catppuccin.lua and change:

local transparent = true -- Set to false to disable transparency

Changing Theme Variant

In lua/plugins/ui/catppuccin.lua, change the colorscheme command:

vim.cmd.colorscheme("catppuccin-mocha")  -- mocha, macchiato, frappe, or latte

Adding Plugins

Add new plugin files in the appropriate category:

• UI plugins → lua/plugins/ui/
  


• Editor plugins → lua/plugins/editor/
  


• LSP plugins → lua/plugins/lsp/
  


• Tools → lua/plugins/tools/
  

They will be automatically loaded by lazy.nvim.

Modifying Keybindings

• Core options: lua/core/options.lua (or lua/vim-options.lua if not migrated)


• Plugin-specific: Edit the individual plugin file

📁 Project Structure

~/.config/nvim/

├── init.lua                    # Entry point with lazy.nvim setup

├── lazy-lock.json              # Plugin version lock file

├── STRUCTURE.md                # Organization guide

├── reorganize.sh               # Migration script

├── README.md                   # This file

│

├── lua/

│   ├── core/                   # Core configuration (optional, organized structure)

│   │   └── options.lua         # Vim options and settings

│   │

│   ├── vim-options.lua         # Vim options (legacy, can be migrated to core/)

│   ├── plugins.lua             # Lazy.nvim bootstrap

│   │

│   └── plugins/                # Plugin configurations (organized by category)

│       ├── ui/                 # UI & Appearance

│       │   ├── catppuccin.lua

│       │   ├── lualine.lua

│       │   ├── bufferline.lua

│       │   ├── noice.lua

│       │   ├── snacks.lua

│       │   ├── dressing.lua

│       │   ├── fidget.lua

│       │   └── nvim-colorizer.lua

│       │

│       ├── editor/             # Editor enhancements

│       │   ├── treesitter.lua

│       │   ├── autopairs.lua

│       │   ├── comment.lua

│       │   ├── which-key.lua

│       │   ├── ufo.lua

│       │   ├── nvim-tree.lua

│       │   └── oil.lua

│       │

│       ├── lsp/                # LSP & Completion

│       │   ├── lsp-config.lua

│       │   ├── completions.lua

│       │   ├── none-ls.lua

│       │   └── formatting.lua

│       │

│       ├── git/                # Git tools (future)

│       │

│       └── tools/              # Development tools

│           ├── copilot.lua

│           ├── toggleterm.lua

│           ├── lazydocker.lua

│           ├── vim-test.lua

│           ├── cord.lua

│           └── ...

🔧 Troubleshooting

Plugins not installing

# Inside Neovim

:Lazy sync

LSP not working

# Inside Neovim

:LspInfo

:Mason

Treesitter errors

# Inside Neovim

:TSUpdate

💡 Tips

1. 
   Health Check - Use :checkhealth to diagnose issues


2. 
   Plugin Manager - Run :Lazy to manage plugins


3. 
   LSP Servers - Use :Mason to install LSP servers, formatters, and linters


4. 
   Keybinding Help - Press <leader> and wait to see available keybindings (which-key)


5. 
   Transparency - Toggle in lua/plugins/ui/catppuccin.lua with one line


6. 
   Now Playing - Dashboard shows your current song via playerctl (Spotify, VLC, etc.)


7. 
   Command Palette - Press : for centered command palette with icons


8. 
   Code Folding - Use za to toggle folds, zR/zM to open/close all

🙏 Acknowledgments

Thanks to the Neovim community and all plugin authors for their amazing work!

Special thanks to:

• 
  folke - For lazy.nvim, noice.nvim, and snacks.nvim


• 
  catppuccin - For the beautiful theme


• The entire Neovim community for making this possible

⭐ Support

If this configuration helped you or inspired your setup, please consider:

• ⭐ Starring the repository - It really motivates me!


• 🍴 Forking and customizing - Make it your own


• 🐛 Reporting issues - Help improve it for everyone


• 💬 Sharing feedback - Let me know what you think

Star the repo if you found it helpful! It means a lot to me! ⭐

Note: I use Arch btw 🐧