npx aftercare deploy github
npx aftercare deploy netlify
# replace existing:
npx aftercare deploy github --force
01
GitHub Pages
WorkflowWrites .github/workflows/aftercare-pages.yml.
- Commit and push to
main - 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.tomlBuild: npx aftercare doctor && npx aftercare build · Publish: dist · Node: 22.
Import the repository in Netlify and deploy.
03
Manual
Any Static Hostnpx 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