A modern, blazing-fast Neovim distribution designed for an exceptional development experience.

💡 Problem & Solution

Problem: There are many excellent Neovim distributions available, but most require extensive configuration to get a smooth, modern development experience. This setup process can be time-consuming and frustrating, especially for newcomers.

Solution: NitroVim comes pre-configured with:

• Fast startup with lazy-loaded plugins
• Modern UI with 20+ themes and transparency support
• Built-in LSP, fuzzy finder, git integration, and more
• Smart defaults for keybindings and code navigation

With NitroVim, you get a ready-to-use, blazing-fast Neovim setup without spending hours configuring plugins and settings. Just install, and start coding.

📚 Table of Contents

• Features
• Keybindings
• Installation
• Plugins
• Language Support
• Customization
• Troubleshooting

✨ Features

• 🚀 LSP Integration - Native language server support
• 💡 Smart Completion - Context-aware suggestions
• 🔍 Fuzzy Finding - Quick file and text search
• 🌳 File Explorer - Tree-style project navigation
• 🎨 20+ Themes - With transparency support
• ⚡ Lazy Loading - Fast startup times
• 📦 Git Integration - Built-in source control
• 🔌 Plugin System - Extensible architecture
• 🪟 Transparent UI — Adjustable window and panel opacity for seamless desktop blending

⌨ Keybindings

General

Key	Action
<Space>	Leader key
<C-\>	Toggle terminal
<leader>lg	Open Lazygit
<C-n>	Toggle file explorer
<C-p>	Find files
<leader>ff	Fuzzy finder

LSP

Key	Action
gd	Go to definition
gr	Show references
K	Show hover
<leader>ca	Code actions
<leader>rn	Rename symbol

Navigation

Key	Action
<C-h>	Window left
<C-j>	Window down
<C-k>	Window up
<C-l>	Window right
<leader>l	Next buffer
<leader>k	Previous buffer

Code

Key	Action
gcc	Toggle comment
<leader>f	Format document
]d	Next diagnostic
[d	Previous diagnostic

Theme & Appearance

Command	Description
:TransparentEnable	Enable transparency
:TransparentDisable	Disable transparency
:TransparentToggle	Toggle transparency
:ThemeSwitch	Open theme switcher menu

Learning & Documentation

Command	Description
:NitroLearn	Open NitroVim learning dashboard

🛠️ Installation

Prerequisites

• Neovim >= 0.8.0
• Git
• Node.js >= 14 (for LSP)
• A Nerd Font
• Lazygit (for git integration)

Installing Lazygit

Windows (using winget):

winget install jesseduffield.lazygit

Windows (using Chocolatey):

choco install lazygit

Windows (using Scoop):

scoop install lazygit

macOS:

brew install lazygit

Linux (using snap):

snap install lazygit

Linux (using pacman):

pacman -S lazygit

Manual Installation: Download the latest release from Lazygit Releases

Windows (Powershell)

# Install Neovim
winget install Neovim.Neovim
# OR with Chocolatey
choco install neovim

# Clone NitroVim
git clone https://github.com/usmonovshohruxmirzo/nitrovim "$env:LOCALAPPDATA\nvim"

Linux/macOS

# Clone configuration
git clone https://github.com/usmonovshohruxmirzo/nitrovim ~/.config/nvim

🔌 Plugins

Core plugins included:

• nvim-tree (File explorer)
• telescope.nvim (Fuzzy finder)
• mason.nvim (LSP installer)
• nvim-cmp (Completion)
• treesitter (Syntax)
• toggleterm (Terminal)
• gitsigns (Git integration)
• bufferline (Tab management)
• lualine (Status line)
• noice.nvim (UI improvements)
• project.nvim (Project management)
• auto-session (Session management)

🎯 Language Support

Built-in support for:

• JavaScript/TypeScript
• Python
• C#/.NET
• HTML/CSS
• React/Next.js
• Lua
• Markdown
• JSON/YAML
• And more...

⚙️ Customization

Adding Plugins

Edit lua/nitro/plugins/plugins.lua:

require("lazy").setup({
  -- Add your plugins here
  { "author/plugin-name" },
})

Changing Settings

Edit lua/nitro/core/options.lua:

vim.opt.option_name = value

Custom Keymaps

Edit lua/nitro/core/keymaps.lua:

vim.keymap.set('mode', 'key', 'action')

📸 Screenshots

Dashboard

Editor

Fuzzy Finder

LazyGit

20+ Themes

Transparency

🔧 Troubleshooting

1. Run health checks:

:checkhealth

2. Update plugins:

:Lazy update

3. Common issues:

   • Icons not showing? Install a Nerd Font
   • LSP not working? Run :Mason to install servers
   • Slow startup? Check :Lazy profile

4. Reporting Issues: If you encounter any problems:

   1. Check the existing issues first
   2. Open a new issue with:
      • NitroVim version (git rev-parse HEAD in your config directory)
      • Neovim version (:version)
      • Operating system
      • Steps to reproduce
      • Expected vs actual behavior
      • Screenshots/error messages if applicable
      • Relevant config files or changes you made

📊 Performance

• Startup Time: ~50ms
• Memory Usage: ~100MB
• Lazy-loaded plugins: 80%

🤝 Contributing

1. Fork the repository
2. Create feature branch
3. Commit changes
4. Push to branch
5. Create Pull Request

📜 License

MIT © Shohruxmirzo Usmonov

Made with ❤️ by the NitroBrain team