Getting Started
Operational documentation for whallc.com — architecture, deployment, theme system, and day-to-day maintenance.
Operational documentation for the Women's Healthcare Associates website. Covers architecture, deployment, the theme and component system, plugin management, and known issues.
Start Here
- Architecture — Directory structure, system diagram, how the pieces connect.
- Local Development — Docker setup, theme dev workflow, available commands.
- Deployment — Build process, staging and production pipelines, environment variables.
- Theme System — wha2025 theme, Tailwind config, component system, ACF integration.
- Custom Post Types — All CPTs, their data models, and relationships.
- Plugin System — Composer-managed, yax mu-plugins, custom wha plugins, update workflow.
- Caching — Cache layers from edge to application, invalidation strategies.
- Security — Cloudflare WAF, Nginx hardening, application-level protections.
- Operations — Health monitoring, ephemeral storage, logging, deploys, rollbacks.
- Developer Reference — Query builder, component system, helper utilities.
- Gotchas — Things that will bite you. Read before touching anything unfamiliar.
The Site
| Property | Value |
|---|---|
| Production | whallc.com |
| Staging | staging.whallc.com, whallc.joeyyax.dev |
| Stack | WordPress · PHP · MySQL · Redis · Nginx |
| Theme | wha2025 |
| Hosting | Heroku |
| CDN/DNS | Cloudflare |
| Repo | [email protected]:joeyyax/womens-healthcare-associates.git |
WordPress core lives at /wp/, managed by Composer via johnpbloch/wordpress-core. Project-owned files live in src/. The front controller at index.php bootstraps WordPress from /wp/wp-blog-header.php.
Branches
| Branch | Purpose |
|---|---|
master | Production — deploys to whallc.com |
staging | Staging — deploys to staging.whallc.com |
Feature branches merge to staging for QA, then to master for production.
Quick Reference
| Need to... | Do this |
|---|---|
| Start local dev | npm run start (Docker) then cd src/wp-content/themes/wha2025 && npm run dev |
| Build for deploy | npm run build (from project root) |
| Run WP-CLI | npm run wp -- <command> |
| Shell into container | npm run shell |
| View logs | npm run logs |
| Flush all caches | docker compose exec redis redis-cli FLUSHALL && npm run wp -- cache flush |
| Access wp-admin | /wp/wp-admin/ (note the /wp/ prefix) |