🚀 Awesome Vim

A batteries‑included, modern Vim distribution that just works.
Perfect for developers, writers, and terminal lovers who want IDE‑like power without leaving Vim.

Replace this with an actual screenshot or an animated GIF of your Vim setup.

✨ Features at a glance

• 🔌 Smart plugin management – uses vim-plug for lightning‑fast, parallel updates.
• 💡 LSP‑ready – seamlessly integrates with coc.nvim for autocompletion, go‑to‑definition, and diagnostics.
• 🌲 Beautiful syntax – improved highlighting and folding via Tree‑sitter (Neovim) or modern syntax plugins (Vim).
• 🔍 Fuzzy finding everywhere – files, buffers, grep results, commands – with fzf and fzf.vim.
• 📁 Project drawer – NERDTree with git integration.
• 🎨 Gentle on the eyes – a carefully tuned colorscheme (Gruvbox / OneDark) with airline statusline.
• 🐚 Seamless Git integration – fugitive.vim shows diffs, blame, and commits.
• ⚡ Blazing fast startup – all plugins are lazy‑loaded where possible.
• 🖥️ Cross‑platform – works on Linux, macOS, and Windows (WSL).

📦 One‑command installation

git clone https://github.com/PsymoNiko/awesome-vim.git
cd awesome-vim
chmod +x install.sh
./install.sh

The install.sh script will:

· Backup your existing ~/.vimrc and ~/.vim · Install vim-plug and all plugins · Install system dependencies (curl, git, fzf, ripgrep, etc.) using your native package manager (apt, dnf, pacman, zypper, brew) · Set everything up – no manual steps required

Note: After installation, restart Vim (or run :PlugInstall) if needed – the script does this automatically.

🗺️ Keymaps cheat sheet

Mode Shortcut Action Normal ff Fuzzy find files Normal fg Live grep (ripgrep) Normal fb List open buffers Normal fh Search command history Normal e Toggle file explorer (NERDTree) Normal gd Go to definition (LSP) Normal K Show hover documentation Normal gr Show references Normal [d / ]d Go to previous / next diagnostic Normal ca Code action (fix / refactor) Insert / Autocomplete suggestions Visual J / K Move selected lines up/down Normal gs Git status (fugitive) Normal gc Git commit Normal gp Git push

is set to \ (backslash) by default. You can change it in ~/.vimrc.

🧩 Included plugins (selected)

Plugin Description vim-plug Minimalist plugin manager coc.nvim LSP client & autocompletion engine fzf.vim Fuzzy finder integration NERDTree File explorer vim-fugitive Git wrapper vim-airline Lean statusline gruvbox / onedark.vim Colorschemes vim-commentary Easy commenting vim-surround Manage brackets, quotes, tags

See the full list in vim_folder/plugins.vim or directly in your .vimrc after installation.

🛠️ Customisation

All configuration files live in ~/.vim/:

· ~/.vimrc – main entry point (symlinked from vim_folder/vimrc) · ~/.vim/plugins.vim – plugin list and settings · ~/.vim/coc-settings.json – LSP language server configs · ~/.vim/after/ – filetype‑specific overrides

To tweak anything, simply edit these files and restart Vim – or source them with :source %.

🤝 Contributing

Found a bug? Have a cool idea? Open an issue or submit a pull request. All contributions are welcome – from typo fixes to new plugin suggestions.

📄 License

MIT – do whatever you want, just keep the credits.

---

Maintained with ❤️ by @PsymoNiko If this config saved you time, consider giving it a ⭐ on GitHub!