Vim Configuration for Python, JavaScript, Bash & Web Development

This is my personal Vim configuration tailored for Python, JavaScript, Bash/Shell scripting, and web development. It focuses on ease of use, readability, and productivity while staying close to vanilla Vim.

Two configs are provided:

File	Description
.vimrc	Full config with plugins via vim-plug
.vimrc.lite	Zero-plugin alternative using Vim built-ins only — no :PlugInstall needed

Both configs are cross-platform: macOS (Apple Terminal & iTerm2) and Linux (with xclip fallback when +clipboard is unavailable).

---

Features

• Syntax highlighting
• Line numbers & relative numbers
• Consistent indentation (4 spaces for Python/Bash, 2 for JS/HTML)
• Automatic & smart indentation
• Smart case search with real-time results
• Mouse support
• System clipboard integration (macOS unnamed, Linux unnamedplus, xclip fallback)
• Persistent undo across sessions
• Sensible split behavior
• macOS + Linux compatibility with automatic OS detection
• Trailing whitespace auto-cleanup on save for .py, .sh, .bash

---

.vimrc — Full Config (Plugin-based)

Plugins

• NERDTree — file tree navigation (Ctrl+n / :Tree)
• vim-airline — enhanced status line with ALE integration
• ALE — asynchronous linting and auto-fixing on save
• vim-commentary — easy commenting with gc
• vim-monokai — Monokai color scheme
• emmet-vim — fast HTML/CSS writing
• CtrlP — fuzzy file finder (Ctrl+p)
• auto-pairs — auto-close brackets and quotes
• vim-gitgutter — git diff indicators in the gutter
• vim-polyglot — enhanced syntax highlighting for all languages
• vim-buftabline — visual buffer list at the top of the screen

Linting & Fixing (ALE)

ALE lints in real-time and auto-fixes on save:

Language	Linters	Fixers
Python	flake8, pylint	isort, black (88 char line length)
JavaScript	eslint	prettier
HTML	htmlhint	prettier
Shell/Bash	shellcheck	—

Python Virtual Environment Auto-Detection

When opening a .py file, Vim automatically searches parent directories for .venv or venv and configures ALE linters (flake8, pylint) to use the virtual environment's Python binary.

Installation

1. Install vim-plug:

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

2. Clone this repository:

git clone git@github.com:georgegozal/vim-config.git

3. Copy the .vimrc to your home directory:

cp vim-config/.vimrc $HOME/.vimrc

4. Install plugins — launch Vim and run:

:PlugInstall

---

.vimrc.lite — Zero-Plugin Config

A drop-in alternative for servers, fresh machines, or minimal environments. All features are implemented with Vim built-ins — no external plugins or internet access required.

Full .vimrc	.vimrc.lite equivalent
NERDTree	netrw (Lexplore)
vim-airline	custom built-in statusline
CtrlP	set path+=** + :find with tab completion
vim-commentary	custom ToggleComment() function
vim-buftabline	custom BufTabLine() function

Comment toggling (\c) is filetype-aware and supports: Python, Bash/Shell, Zsh, YAML, JavaScript, Java, C/C++, Vim, HTML, XML.

Usage

# Use instead of ~/.vimrc for a single session
vim -u ~/.vimrc.lite

# Add a shell alias for convenience (add to ~/.bashrc or ~/.zshrc)
alias viml="vim -u ~/.vimrc.lite"

# Or install permanently
cp vim-config/.vimrc.lite $HOME/.vimrc

---

Key Mappings

Both configs share the same key mappings.

File Navigation

• Ctrl+n — toggle file explorer (NERDTree or netrw)
• Ctrl+p — fuzzy file finder (CtrlP, full config only)
• :Tree — command alias to open file explorer
• :find <name> — fuzzy file search with tab completion (lite config)

NERDTree File Opening (full config)

• Enter — open file in current window
• i — open file in horizontal split
• s — open file in vertical split
• t — open file in new tab

Buffer Management

• \n — next buffer
• \p — previous buffer
• \d — delete buffer
• \b — show buffer list and switch
• \1 to \5 — jump to buffer 1–5
• \x — delete buffer without closing window
• :ls — show all open buffers

Window Navigation

• Ctrl+w h/j/k/l — move between windows

Splits

• \v — vertical split
• \s — horizontal split

Editing

• jk — escape insert mode (alternative to Esc)
• Ctrl+s — save file
• \w — quick save
• \q — quick quit
• \h — clear search highlights
• \c — toggle comment (lite config; use gc in full config)

Line Movement

• Ctrl+j — move current line/selection down
• Ctrl+k — move current line/selection up
• Alt+j / Alt+k — same (only available in iTerm2 on macOS)

Visual Mode

• < — indent left (keeps selection)
• > — indent right (keeps selection)

---

File Type Settings

Language	Indentation
Python	4 spaces
Bash / Shell scripts	4 spaces
JavaScript	2 spaces
HTML / XML	2 spaces
JSON / YAML	2 spaces

---

Colorscheme

• Full config: Monokai (via vim-monokai plugin), falls back to desert
• Lite config: desert with custom highlight tweaks for cursor line, line numbers, and status bar

---

Screenshots

---

Contributing

If you have suggestions or improvements, feel free to fork this repo and submit a pull request!

---

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). You are free to use, modify, and distribute this configuration, provided that any modifications are also released under the same license.