Skip to content

Reference

Reference material for using and customizing the framework.

In this section

  • 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.
  • Repository Structure — the full file layout, what bootstrap.sh does, and the symlinked-vs-copied distinction.
  • Onboarding Runbook — step-by-step new-machine setup from clone through validation.
  • Troubleshooting — common issues with mise, git identity, SSH, shell startup, and direnv.