Overview

Home for my (Jon) dotfiles and environment configuration

Motivation

Consistency.

Dependencies

Common:

• GNU Stow
• Ghostty

macOS:

• Homebrew
• iTerm2

Linux:

• Sway

Installation

Clone with submodules:

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

If already cloned without submodules:

git submodule update --init --recursive

Stow

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 packages:

cd ~/.dotfiles
stow --verbose --target=$HOME */

Symlink a specific package:

stow --verbose --target=$HOME bash

Remove all symlinks:

stow --verbose --target=$HOME --delete */

Re-stow (remove then re-symlink, useful after reorganizing):

stow --verbose --target=$HOME --restow */

Makefile

The Makefile wraps common setup tasks:

make          # stow all packages + vim/shell setup
make stow     # symlink all packages
make unstow   # remove all symlinks
make vim      # set up Vim/Vundle
make shell    # clone shell dependencies (kube-ps1, zsh-git-prompt)

Submodules

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

Enjoy (or criticize) !