Skip to content

System Requirements

Minimum Requirements

Operating Systems

macOS or Linux (Ubuntu, Fedora, Arch)

Core Dependencies

These tools are required for the essential dotfiles to work:

Tool Purpose macOS Linux
stow Symlink manager brew install stow apt install stow
neovim Editor brew install neovim apt install neovim
tmux Terminal multiplexer brew install tmux apt install tmux
zsh Shell brew install zsh apt install zsh
git Version control brew install git apt install git

These enhance the experience significantly:

Tool Purpose macOS Linux
starship Prompt brew install starship installer
fzf Fuzzy finder brew install fzf apt install fzf
ripgrep Fast grep brew install ripgrep apt install ripgrep
fd Fast find brew install fd apt install fd-find
lazygit Git TUI brew install lazygit releases

Optional

Tool Purpose Install
lazydocker Docker TUI brew install lazydocker
k9s Kubernetes TUI brew install k9s
kitty Terminal emulator brew install --cask kitty
aerospace macOS window manager brew install --cask aerospace

Quick Install (macOS)

# Core
brew install stow neovim tmux zsh git

# Recommended
brew install starship fzf ripgrep fd lazygit

# Optional
brew install lazydocker k9s
brew install --cask kitty aerospace

Quick Install (Ubuntu/Debian)

# Core
sudo apt update
sudo apt install stow neovim tmux zsh git

# Recommended
sudo apt install fzf ripgrep fd-find

# Starship (installer)
curl -sS https://starship.rs/install.sh | sh

# lazygit (from releases)
# See: https://github.com/jesseduffield/lazygit#installation