A powerful Neovim distribution designed for developers who want maximum productivity and performance.

A powerful, modern, and extensible Neovim configuration built for developers who want a fast, beautiful, and feature-rich editing experience.

• Lazy Loading - Fast startup times with lazy.nvim
• LSP Integration - Full Language Server Protocol support with mason.nvim
• Modern UI - Beautiful dashboard, statusline, and file explorer
• Smart Autocompletion - Powered by nvim-cmp with multiple sources
• Fuzzy Finding - Telescope with fzf-native for blazing fast searches
• Git Integration - Built-in git tools and status indicators
• Session Management - Automatic session saving and restoration
• Terminal Integration - Floating and split terminal support

• Web Development: JavaScript, TypeScript, HTML, CSS, React, Vue, Svelte
• Systems Programming: Rust, Go, C/C++
• Scripting: Python, Lua, Bash
• Configuration: YAML, JSON, TOML
• Documentation: Markdown

• lazy.nvim - Modern plugin manager
• mason.nvim - LSP server, formatter, and linter manager
• nvim-lspconfig - Native LSP configuration
• nvim-cmp - Autocompletion engine
• telescope.nvim - Fuzzy finder
• nvim-treesitter - Syntax highlighting and parsing

• dashboard-nvim - Beautiful startup screen
• lualine.nvim - Statusline with git and LSP info
• bufferline.nvim - Tab-like buffer management
• nvim-tree.lua - File explorer
• indent-blankline.nvim - Indentation guides
• tokyonight.nvim & mp; catppuccin - Modern colorschemes

• conform.nvim - Code formatting
• nvim-lint - Linting integration
• trouble.nvim - Diagnostics panel
• gitsigns.nvim - Git signs in the gutter
• vim-fugitive - Git integration
• toggleterm.nvim - Terminal management

• which-key.nvim - Keybinding discovery
• nvim-surround - Surround text objects
• nvim-autopairs - Auto-close brackets
• comment.nvim - Smart commenting
• auto-session - Session management
• todo-comments.nvim - Highlight TODOs

• Neovim >= 0.9.09.0
• Git
• A Nerd Font (for icons)
• ripgrep (for telescope grep)
• Node.js (for some LSP servers)
• Python (for some formatters/linters)

# Backup existing config
mv  ~/.config/nvim ~/.config/nvim.backup


# Clone MaxxVim
git clone https://github.com/shubhisroking/maxxvim.git  ~/.config/nvim


# Start Neovim
nvimm

The first startup will automatically install all plugins and LSP servers.

• ce> - Leader key
• jk - Exit insert mode
• sc> - Clear search highlights

• ff>ff - Find files
• fr>fr - Recent files
• fs>fs - Find string in project
• fb>fb - Find buffers

• gd - Go to definition
• gr - Show references
• K - Show hover documentation
• ca>ca - Code actions
• rn>rn - Rename symbol
• [d / ]d - Navigate diagnostics

• ee>ee - Toggle file explorer
• ef>ef - Find current file in explorer

• gs>gs - Git status
• gb>gb - Git blame
• gc>gc - Git commits (telescope)

• -\> - Toggle floating terminal
• th>th - Horizontal terminal
• tv>tv - Vertical terminal

• xx>xx - Toggle trouble
• xd>xd - Document diagnostics
• xt>xt - Todo comments

The configuration is modular and easy to customize:

• Core settings: lua/config/vim-options.lua
• Keymaps: lua/config/keymaps.lua
• Plugin management: lua/config/lazy.lua
• Individual plugins: lua/plugins/ and lua/plugins/essentials/

MaxxVim comes with two beautiful colorschemes:

• Tokyo Night (default) - A clean dark theme
• Catppuccin - Soothing pastel theme

Switch between them in lua/plugins/colorscheme.lua.

~/.config/nvim/
├── init.lua                    # Entry point
├── lua/
│   ├── config/
│   │   ├── lazy.lua           # Plugin manager setup
│   │   ├── vim-options.lua    # Neovim settings
│   │   └── keymaps.lua        # Key mappings
│   └── plugins/
│       ├── colorscheme.lua    # Color themes
│       ├── dashboard.lua      # Startup screen
│       ├── lualine.lua        # Status line
│       ├── treesitter.lua     # Syntax highlighting
│       ├── terminal.lua       # Terminal integration
│       └── essentials/        # Core functionality plugins
│           ├── lsp.lua        # Language server setup
│           ├── cmp.lua        # Autocompletion
│           ├── telescope.lua  # Fuzzy finder
│           ├── mason.lua      # LSP server manager
│           ├── formatting.lua # Code formatting
│           ├── linting.lua    # Code linting
│           └── ...           # Other essential plugins
r essential plugins

MaxxVim is optimized for speed:

• Startup time: ~50-100ms (depending on your system)
• Lazy loading: Plugins load only when needed
• Optimized runtimepath: Disabled unnecessary built-in plugins
• Modern Lua: Native Neovim Lua for better performance

• Neovim: Official Documentation
• Lua: Learn Lua in Y Minutes
• Plugin Development: nvim-lua-guide

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the MIT License - see the LICENSE file for details.

• The Neovim team for creating an amazing editor
• All plugin authors for their fantastic work
• The Neovim community for inspiration and support

Happy coding with MaxxVim! 🎉

For complete setup instructions and configuration guides, visit: https://maxxvim.vercel.app/

git clone https://github.com/your-repo/maxxvim ~/.config/nvim
nvimm