🌌 Terminal Setup — Ghostty + Vim + TMUX (Gruvbox Edition)

A high-performance, aesthetically pleasing, zero-dependency development environment optimized for restricted corporate environments, firewalls, and proxy networks.

---

🎨 Aesthetics & Stack

• Theme: Gruvbox Dark — Earthy, warm palette designed for high legibility during long coding sessions.
• Font: JetBrainsMono Nerd Font (Size 15) with fallback monospace fonts.
• Terminal: Ghostty with 24-bit TrueColor support (COLORTERM=truecolor).
• Multiplexer: TMUX (Standalone, zero-TPM runtime dependency).
• Editor: Vim 8+ / Neovim (Pure Vim config, offline themes & TypeScript support).
• Shell: ZSH (Native compinit autocomplete, autosuggestions, syntax-highlighting & proxy helpers).

---

📂 Modular Repository Architecture

Each tool is isolated in its dedicated directory containing configuration files and individual documentation:

.
├── ghostty/
│   ├── config        # Native Ghostty configuration (Gruvbox Dark)
│   └── README.md     # Ghostty documentation & keybindings
├── tmux/
│   ├── tmux.conf     # Standalone TMUX configuration (Gruvbox status bar)
│   ├── preview.sh    # Floating preview popup script
│   └── README.md     # TMUX keybindings & preview popup guide
├── vim/
│   ├── vimrc         # Pure Vim/Neovim configuration
│   ├── colors/       # Vendored offline themes (Gruvbox Dark, Tokyo Night)
│   ├── syntax/       # Offline TypeScript & TSX syntax definitions
│   └── README.md     # Vim keybindings & search guide
├── zsh/
│   ├── zshrc         # Resilient ZSH shell config & proxy helpers
│   ├── mdpreview     # Markdown & Mermaid.js browser previewer script
│   └── README.md     # ZSH documentation & functions
└── README.md         # Repository root overview

---

🚀 Quick Start & Installation

1. Clone & Link Configurations

git clone -b ghostty-vim-tmux https://github.com/malaquiasdev/terminal-setup.git ~/terminal-setup
cd ~/terminal-setup

# Link application configurations
ln -sf ~/terminal-setup/tmux/tmux.conf ~/.tmux.conf
ln -sf ~/terminal-setup/vim/vimrc ~/.vimrc
ln -sf ~/terminal-setup/zsh/zshrc ~/.zshrc
ln -sf ~/terminal-setup/vim ~/.vim

# Link local binary scripts
mkdir -p ~/.local/bin
ln -sf ~/terminal-setup/zsh/mdpreview ~/.local/bin/mdpreview

# Link Ghostty configuration (if Ghostty is installed)
mkdir -p ~/.config/ghostty
ln -sf ~/terminal-setup/ghostty/config ~/.config/ghostty/config

---

⌨️ Key Features & Shortcuts

🪟 TMUX (Prefix: Ctrl + a)

• Panes: Ctrl+a \ (vertical split), Ctrl+a - (horizontal split), Ctrl+a + Arrow Keys or h/j/k/l.
• Preview Popups: Ctrl+a w (floating window preview picker), Ctrl+a p (floating session preview picker).
• Clipboard: Automatic OS clipboard integration (pbcopy on macOS, clip.exe on WSL2, xclip on Linux).

⌨️ Vim / Neovim (Leader: <Space>)

• Navigation: <Space> + Arrow Keys or <Space> + h/j/k/l to switch windows.
• File Explorer: <Space> e to toggle Netrw file tree.
• File Search: <Space> ff to search files by name (:find <Tab>).
• Text Search (Ripgrep): <Space> fg to live grep project text, <Space> fw to grep word under cursor.
• Telescope-Style Quickfix: Aligned, clean search results list with automatic 14-line height (q to close).
• Mermaid.js Preview: <Space> mp to open live rendered Markdown & Mermaid.js diagrams in browser.

🐚 ZSH Shell & Proxy Helpers

• Corporate Proxy: setproxy <url>, showproxy, unsetproxy.
• Smart Launcher: tm (creates or attaches to TMUX session).
• Markdown Previewer: mdpreview <file.md> (renders Markdown + Mermaid.js in browser).

---

📖 Component Documentation

• 👻 Ghostty Setup Guide
• 🪟 TMUX & Preview Popup Guide
• ⌨️ Vim & Search Keybindings Guide
• 🐚 ZSH & Proxy Helper Guide

---

Maintained with ❤️ by malaquiasdev • Branch: ghostty-vim-tmux