Skip to main content

Development Workflow

Repositories​

RepositoryURLPurpose
id86-gp-themegithub.com/donnyaw/id86-gp-themeChild theme source, CSS, JS, PHP
ID86-instant-documentationgithub.com/donnyaw/ID86-instant-documentationReference content Markdown and sync tooling
brain-donnyaw-cf-pagesgithub.com/donnyaw/brain-donnyaw-cf-pagesThis operational documentation
wp-opsgithub.com/donnyaw/wp-opsWordPress automation scripts and operations

Theme Change Process​

  1. Inspect repo state: git status, git diff, git log -5
  2. Make changes only in child-theme files (never in GeneratePress parent).
  3. Validate PHP: php -l functions.php
  4. Check whitespace: git diff --check
  5. Deploy: ./deploy.sh
  6. Clear caches: OPcache, LiteSpeed, Cloudflare
  7. Verify origin markup: curl -ksS --resolve id86.net:443:127.0.0.1 https://id86.net/
  8. Stage only intended files.
  9. Write a concise commit message using conventional commits format.
  10. Push: git push origin main

Git Safety Rules​

  • Never commit SMTP passwords, Reoon API keys, Cloudflare tokens, or private SSH keys.
  • Do not commit .env files or credential paths.
  • Check for secrets before staging: git diff --cached | grep -i 'password\|secret\|key\|token' — if anything shows, unstage and fix.
  • Do not revert unrelated worktree changes.
  • Do not amend or force-push unless explicitly requested by the user.
  • Keep GeneratePress Element changes documented here because they live in the database, not in version control.

Commit Message Style​

Use conventional commits:

feat: add email subscription bar above footer with Reoon verification
fix: correct mobile hero alignment for quick topics
docs(id86): publish site implementation guide
refactor: consolidate search palette renderer
perf: disable Perfmatters on front page for instant search

Deployment Tagging​

When publishing documentation, use date-based tags:

git tag "id86.net-$(date +%Y%m%d-%H%M%S)"