Dotfiles 🦄 💻

How I'm doing dotfiles.

Architecture

Source: docs/dotfiles-architecture.tldraw — open with tldraw offline.

Setup

git clone https://github.com/program247365/dotfiles.git ~/.dotfiles
cd~/.dotfiles
script/bootstrap

Update

~/.dotfiles/bin/dot

Migrations

The /migrations folder contains dated scripts for handling configuration changes and updates when setting up on new machines or after major changes.

Migration scripts are named with the format: YYYY-MM-DD-description.zsh

Running Migrations

Migrations are automatically run when you use the dot command. You can also run them manually:

# Run a specific migration~/.dotfiles/migrations/2025-08-20-lazyvim-setup.zsh
# Run all migrations (done automatically by dot command)forscriptin~/.dotfiles/migrations/*.zsh;doecho"Running migration: $(basename "$script")""$script"done