CHAPTER 06

Deploy

Both recipes run doctor before publish. Broken content stops the deploy.

npx aftercare deploy github
npx aftercare deploy netlify
# replace existing:
npx aftercare deploy github --force
01

GitHub Pages

Workflow

Writes .github/workflows/aftercare-pages.yml.

  1. Commit and push to main
  2. Settings → Pages → Source → GitHub Actions

The workflow installs deps, runs doctor, builds with AFTERCARE_BASE_PATH=/<repo-name>, then uploads dist/.

Base path

Project Pages URLs look like account.github.io/my-site/. Remove AFTERCARE_BASE_PATH (or clear basePath) for a custom domain or the special account.github.io repository.

02

Netlify

netlify.toml

Build: npx aftercare doctor && npx aftercare build · Publish: dist · Node: 22.

Import the repository in Netlify and deploy.

03

Manual

Any Static Host
npx aftercare doctor
npx aftercare build
# upload dist/
$env:AFTERCARE_BASE_PATH = "/my-subpath"
npx aftercare build
04

Checklist

Pre-Flight
01 Doctor clean Zero errors from npx aftercare doctor REQ
02 AGENTS.md current Sync after any theme contract change REQ
03 Images on disk Local paths under public/ match content REQ
04 Base path Matches how the site will be served REQ
Colophon
Built once. Maintained with Aftercare.
END OF MANUAL · RETURN TO INDEX