Dotfiles

Personal configuration files for development environment setup.

Note: Some configurations are optimized for macOS and may require adjustments for other operating systems.

What's Included

• nvim - Neovim configuration with plugins and themes
• zsh - Shell configuration and aliases
• tmux - Terminal multiplexer configuration
• ghostty - Terminal emulator config with shaders and themes
• zed - Code editor themes and settings
• lazygit - Git TUI configuration
• gitconfig - Git configuration
• opencode - OpenCode AI assistant configuration

Installation

Prerequisites

Before setting up the dotfiles, ensure you have the following installed:

1. Xcode Command Line Tools

   xcode-select --install

2. Homebrew

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. GNU Stow (via Homebrew)

   brew install stow

Setup

Uses GNU Stow for symlink management.

Important: Before running the installation scripts, make them executable:

chmod +x stow install

Quick Setup

./stow

Manual Installation

# Set environment variables (optional)
export DOTFILES=$HOME/.dotfiles
export STOW_FOLDERS="tmux,zsh,nvim,ghostty,zed,lazygit,gitconfig,opencode"

# Run install script
./install

The install script will:

1. Remove any existing symlinks for each package
2. Create fresh symlinks to your home directory

macOS Configuration

Keyboard Settings

Improve keyboard responsiveness for faster typing:

# Reduce key repeat delay and increase repeat rate
defaults write -g InitialKeyRepeat -int 9
defaults write -g KeyRepeat -int 1
defaults write -g ApplePressAndHoldEnabled -bool false

Dock Settings

Make Dock auto-hide more responsive:

# Remove delay when auto-hiding Dock
defaults write com.apple.dock autohide-delay -int 0
defaults write com.apple.dock autohide-time-modifier -float 0.4
killall Dock

Structure

Each directory represents a package that can be independently stowed:

.dotfiles/
├── ghostty/          # Terminal emulator
├── gitconfig/        # Git configuration
├── lazygit/          # Git TUI
├── nvim/             # Neovim editor
├── opencode/         # OpenCode AI assistant
├── tmux/             # Terminal multiplexer
├── zed/              # Code editor
└── zsh/              # Shell