Development Environment Setup

## ~/.zshrc
## -- History --
HISTFILE=~/.zsh_history
HISTSIZE=50000
SAVEHIST=50000
setopt HIST_IGNORE_ALL_DUPS
setopt HIST_SAVE_NO_DUPS
setopt SHARE_HISTORY
setopt INC_APPEND_HISTORY

# -- Completion --
autoload -Uz compinit && compinit
zstyle ':completion:*' menu select
zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'

# -- Key bindings --
bindkey -e
bindkey '^p' history-search-backward
bindkey '^n' history-search-forward

# -- Plugins (using zinit) --
# Install zinit:
# bash -c "$(curl --fail --show-error --silent --location https://raw.githubusercontent.com/zdharma-continuum/zinit/HEAD/scripts/install.sh)"

# Source starship prompt
eval "$(starship init zsh)"

# Install
curl -sS https://starship.rs/install.sh | sh

# Minimal config (~/.config/starship.toml)
add_newline = false
character = { success_symbol = "[>](bold green)", error_symbol = "[>](bold red)" }
[directory]
truncation_length = 3
truncate_to_repo = true
[git_branch]
symbol = " "
[git_status]
disabled = false

# Stow creates symlinks:
stow zsh    # ~/.zshrc -> ~/dotfiles/zsh/.zshrc
stow git    # ~/.gitconfig -> ~/dotfiles/git/.gitconfig
stow nvim   # ~/.config/nvim/init.lua -> ~/dotfiles/nvim/.config/nvim/init.lua

# Unstow (remove symlinks):
stow -D zsh

# Install
sh -c "$(curl -fsLS get.chezmoi.io)"

# Initialize from a git repo
chezmoi init https://github.com/yourusername/dotfiles.git

# Apply
chezmoi apply

# Edit a file (opens in $EDITOR)
chezmoi edit ~/.zshrc

# Diff (show changes that would be applied)
chezmoi diff

# Install
sudo apt install tmux  # Linux
brew install tmux       # macOS

# Essential key bindings (prefix = Ctrl+B)
# Sessions
tmux new -s work        # Create named session
tmux ls                 # List sessions
tmux attach -t work     # Attach to session
Ctrl+B, d               # Detach from session

# Windows (tabs)
Ctrl+B, c               # Create new window
Ctrl+B, n               # Next window
Ctrl+B, p               # Previous window
Ctrl+B, ,               # Rename window

# Panes
Ctrl+B, %               # Vertical split
Ctrl+B, "               # Horizontal split
Ctrl+B, arrows          # Navigate panes
Ctrl+B, z               # Toggle pane zoom

# Core settings
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --global pull.rebase true
git config --global fetch.prune true

# GPG commit signing
git config --global user.signingkey YOUR_GPG_KEY_ID
git config --global commit.gpgsign true
git config --global gpg.program gpg

# SSH key signing (alternative to GPG)
git config --global gpg.format ssh
git config --global user.signingkey ~/.ssh/id_ed25519.pub
git config --global commit.gpgsign true

# Useful aliases
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.st status
git config --global alias.lg "log --oneline --graph --decorate --all"
git config --global alias.last "log -1 HEAD --stat"

# Generate ED25519 key (preferred)
ssh-keygen -t ed25519 -C "you@example.com"

# Generate RSA key (for legacy systems)
ssh-keygen -t rsa -b 4096 -C "you@example.com"

# Start SSH agent and add key
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# Copy public key to remote host
ssh-copy-id user@remote-host

# Install
# Linux: sudo apt install fzf
# macOS: brew install fzf

# fzf integrates with shell history, file finding, and more
# Ctrl+R  — fuzzy history search
# Ctrl+T  — fuzzy file finder (inserts path)
# Alt+C   — fuzzy cd

# Advanced: fzf with preview
fzf --preview 'bat --color=always {}'

# Use with ripgrep for project-wide search
rg --color=always --line-number "" | fzf --ansi --delimiter : --preview 'bat --color=always {1} --highlight-line {2}'

# Enter a nix shell with specific tools
nix shell nixpkgs#go nixpkgs#golangci-lint nixpkgs#protobuf

# Use a flake for a project
# flake.nix defines the development shell
nix develop  # Enter the development shell

# Install Go
# macOS: brew install go
# Linux: sudo apt install golang-go

# Essential tools
go install golang.org/x/tools/gopls@latest    # Language server
go install github.com/go-delve/delve/cmd/dlv@latest  # Debugger
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest  # Linter
go install honnef.co/go/tools/cmd/staticcheck@latest  # Static analysis

# VS Code extensions:
# - Go (official)
# - Go Nightly (experimental features)

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Essential tools
rustup component add rust-analyzer clippy rustfmt
cargo install cargo-expand cargo-audit cargo-flamegraph

# VS Code extensions:
# - rust-analyzer (official)
# - CodeLLDB (debugger)
# - Even Better TOML
# - Crate Graph

# Install Python (use pyenv for version management)
brew install pyenv  # macOS
pyenv install 3.12.0
pyenv global 3.12.0

# Essential tools
pip install black ruff mypy pytest ipython

# VS Code extensions:
# - Python (official)
# - Ruff (linter + formatter)
# - Pylance (type checking)

# Install Node.js (use fnm or nvm for version management)
curl -fsSL https://fnm.vercel.app/install | bash
fnm install 22
fnm use 22

# Install pnpm (required by this project)
corepack enable
pnpm --version  # should be 10+

# VS Code extensions:
# - TypeScript Vue Plugin (Volar) or ES7+ React snippets
# - ESLint
# - Prettier
# - Tailwind CSS IntelliSense

# 1. Create a feature branch from main
git checkout main
git pull
git checkout -b feature/my-feature

# 2. Make changes, commit frequently
git add -p
git commit -m "Add user authentication endpoint"

# 3. Keep up with main
git fetch origin
git rebase origin/main

# 4. Push and create PR
git push -u origin feature/my-feature
gh pr create --title "Add user authentication" --body "Description"

# Session layout for a web development project:
# Window 0: Editor (vim/nvim)
# Window 1: Terminal (run server, tests)
# Window 2: Git (status, log)
# Window 3: Monitoring (logs, metrics)

tmux new-session -s dev -d -n editor
tmux new-window -n terminal
tmux new-window -n git
tmux new-window -n monitor

# Send commands to specific windows
tmux send-keys -t dev:editor "vim" Enter
tmux send-keys -t dev:terminal "pnpm start" Enter
tmux send-keys -t dev:git "git status" Enter

# Add to ~/.zshrc (after sourcing zinit/plugins):
# Ctrl+R — fuzzy history search
# Ctrl+T — fuzzy file finder
# Alt+C  — fuzzy cd

# fzf-tab completion (replaces default tab completion)
zinit light zsh-users/zsh-autosuggestions
zinit light Aloxaf/fzf-tab

# fzf git integration
# Browse git log interactively
git log --oneline --color=always | fzf --ansi --preview 'git show {1} --stat'

# Install
brew install direnv  # macOS
sudo apt install direnv  # Linux

# Hook into zsh
eval "$(direnv hook zsh)"

# Create a per-project .envrc
# cd into your project directory
echo 'export DATABASE_URL=postgres://localhost/mydb' > .envrc
echo 'export PORT=3000' >> .envrc
direnv allow  # Approve the .envrc

# .env (never commit to git)
DATABASE_URL=postgres://localhost/mydb
SECRET_KEY=your-secret-key
PORT=3000

# .env.example (commit to git)
DATABASE_URL=postgres://localhost/mydb
SECRET_KEY=change-me
PORT=3000

# Load in shell (for local development)
export $(cat .env | xargs)