• Overview
• Features
• Screenshots
• Requirements
• Installation
• Plugins
• Keybindings
• Customization
• Troubleshooting
• Contributing
• License

This Vim configuration provides a powerful, modern development environment while maintaining the traditional Vim experience. It includes carefully selected plugins for file navigation, Git integration, syntax highlighting, and intelligent code completion.

• Non-invasive: Respects traditional Vim workflows
• Well-documented: Every setting is explained
• Modular: Easy to enable/disable plugins
• Performance-focused: Lazy loading and optimized settings

• 🎨 Beautiful UI - Gruvbox theme with Airline status bar
• 📁 File Navigation - NERDTree sidebar and FZF fuzzy finder
• 🔍 Smart Search - Fast file and content search with ripgrep integration
• 🎯 Code Intelligence - LSP-powered autocompletion via CoC.nvim
• 🔧 Auto-formatting - Format on save with ALE
• 📝 Git Integration - Fugitive and GitGutter for Git workflows
• 🌈 Syntax Highlighting - Enhanced support for JS, TS, Python, Go, Rust
• ⚡ Fast - Optimized for performance with lazy loading
• 🎹 Intuitive Keybindings - Spacebar as leader key

┌─────────────────────────────────────────────────────────────┐
│ NORMAL  ~/.vim/vimrc                              80% ☰ 1:1 │ ← Airline
├──────────┬──────────────────────────────────────────────────┤
│▾ .vim/   │  1  " Vim Configuration                          │
│  ▾ plugged│  2  set number                                   │
│    ale    │  3  set relativenumber                           │
│    fzf    │  4                                               │
│  autoload │  5  " Leader key = Space                         │
│  vimrc    │  6  let mapleader = " "                          │
│  README.md│  7                                               │
│           │  8  " Fast file search: <Space>ff                │
└──────────┴──────────────────────────────────────────────────┘
  NERDTree           Main Editor Area

• Vim 9.0+ (or Neovim 0.5+)
• Git - For vim-plug and plugins
• Node.js 14+ - For CoC.nvim

# macOS
brew install fzf ripgrep universal-ctags

# Ubuntu/Debian
sudo apt install fzf ripgrep universal-ctags

# Arch Linux
sudo pacman -S fzf ripgrep universal-ctags

# macOS
brew tap homebrew/cask-fonts
brew install --cask font-hack-nerd-font

# Then configure your terminal to use "Hack Nerd Font"

# Backup existing config
mv ~/.vim ~/.vim.backup 2>/dev/null
mv ~/.vimrc ~/.vimrc.backup 2>/dev/null

# Clone this repo
git clone https://github.com/yourusername/vim-config.git ~/.vim

# Install vim-plug
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

# Install plugins
vim +PlugInstall +qall

# Install CoC extensions
vim -c 'CocInstall -sync coc-json coc-tsserver coc-python coc-go|q'

1. Install vim-plug

   curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
       https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

2. Copy vimrc

   cp vimrc ~/.vim/vimrc
   # Or symlink: ln -s ~/.vim/vimrc ~/.vimrc

3. Open Vim and install plugins

   :PlugInstall

4. Install language servers (optional)

   :CocInstall coc-json coc-tsserver coc-python coc-go coc-rust-analyzer

The leader key is set to Space for easy access.

let mapleader = " "

If you prefer traditional Vim (no mouse):

set mouse=                    " Already disabled by default

Comment out plugins you don't want in vimrc:

" Disable auto-pairs
" Plug 'jiangmiao/auto-pairs'

" Disable CoC (use native completion)
" Plug 'neoclide/coc.nvim', {'branch': 'release'}

Then run :PlugClean in Vim.

" Options: gruvbox, solarized, molokai, dracula
colorscheme gruvbox
set background=dark          " or 'light'

set tabstop=2                 " Tab size (default: 4)
set shiftwidth=2              " Indent size (default: 4)
set expandtab                 " Use spaces (noexpandtab for tabs)

" In ALE section (~line 169)
let g:ale_fix_on_save = 0     " Change from 1 to 0

let mapleader = ","           " Use comma instead of space

Problem: Squares or missing icons in NERDTree

Solution: Install a Nerd Font and configure your terminal

brew install --cask font-hack-nerd-font
# Set terminal font to "Hack Nerd Font"

Problem: [coc.nvim] CoC server process not initialized

Solution: Install Node.js

# macOS
brew install node

# Ubuntu
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

Problem: :Files command not working

Solution: Install FZF

brew install fzf    # macOS
sudo apt install fzf  # Ubuntu

Problem: Vim takes long to start

Solution: Disable language servers you don't need

:CocUninstall coc-go  # If you don't use Go

Problem: Code formatted incorrectly

Solution: Configure formatter for your language

let g:ale_fixers = {
\   'javascript': ['prettier'],
\   'python': ['black'],
\}

• OpenVim Tutorial
• Vim Adventures (Game)
• :help user-manual - Built-in manual

• :help nerdtree - NERDTree help
• :help fzf-vim - FZF help
• :help coc-nvim - CoC help

• Vim Cheat Sheet
• Vim Surround Examples

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing)
5. Open a Pull Request

• Document new plugins in README
• Add comments for non-obvious settings
• Test with clean Vim installation
• Update keybinding table if needed

Some plugins are commented out to maintain traditional Vim behavior:

• vim-multiple-cursors - Conflicts with NERDTree Ctrl+n

To enable, uncomment in vimrc and run :PlugInstall.

Auto-indent is configured per language:

• Python: 4 spaces
• JavaScript/TypeScript: 2 spaces
• Go: tabs (no expansion)

• vim-plug - Minimalist plugin manager
• Gruvbox - Beautiful color scheme
• All plugin authors for their amazing work

MIT License - Feel free to use and modify!

If you find this configuration useful, please star the repository!