Skip to content

Reference

Start here. This section covers everything you need to install, configure, and maintain the dotfiles — the practical information bound directly to the repository artifact.

In this section

  • Repository Structure — the full file layout, what bootstrap.sh does, and the symlinked-vs-copied distinction.
  • Platform Setup — machine-level optimization for a fresh OS install. Covers macOS, Fedora, and Debian/Ubuntu. Run before the Onboarding Runbook.
  • Onboarding Runbook — step-by-step new-machine setup from clone through validation.
  • Customization — the placeholder string convention, what to substitute when forking, version notes, and the relationship between this site and earlier framework versions.
  • Test Suite — the 30-test POSIX test suite for the ~/.profile shim, with test groups and key tests explained.
  • Troubleshooting — common issues with mise, git identity, SSH, shell startup, and direnv.