Overview

Home for my (Jon) dotfiles and environment configuration

Consistency.

Common:

• GNU Stow
• Ghostty

macOS:

• Homebrew
• iTerm2

Linux:

• Hyprland
• Quickshell
• Ghostty

Legacy desktop configs (sway, i3, alacritty, wofi) are in legacy/ and are not deployed by default.

Clone with submodules:

git clone --recurse-submodules https://github.com/<user>/dotfiles.git ~/.dotfiles

If already cloned without submodules:

git submodule update --init --recursive

GNU Stow manages symlinks from the dotfiles repo into $HOME. Each top-level directory is a stow package that mirrors the target directory structure.

Symlink all active packages:

cd ~/.dotfiles
make stow

Symlink a specific package:

stow --verbose --target=$HOME bash

Remove all active symlinks:

make unstow

Re-stow (useful after reorganizing):

make stow

The Makefile wraps common setup tasks:

make          # stow active packages + vim/shell setup
make stow     # symlink active packages (see STOW_PACKAGES in Makefile)
make unstow   # remove active symlinks
make check    # dry-run stow
make vim      # set up Vim/Vundle
make shell    # clone shell dependencies (kube-ps1, zsh-git-prompt)

• tpm — Tmux Plugin Manager (tmux/.config/tmux/plugins/tpm)

Enjoy (or criticize) !