Overview
The home for building, running, editing and growing whallc.com, for developers, maintainers and the content and marketing team alike.
Documentation for the Women's Healthcare Associates website. Everything needed to build, run, edit and grow whallc.com. It's written for two audiences: the developers and maintainers who operate the platform, and the content editors and marketers who keep it accurate and findable.
How it's built
WordPress runs a huge share of the web for good reasons: a massive ecosystem, a familiar editing experience, and no licensing cost. But plenty of WordPress sites are built carelessly: a pile of plugins, hardcoded config, no build step, no tests, edited straight in production. This one isn't.
whallc.com is built with the engineering discipline you'd expect of any production application. Dependencies are pinned and managed with Composer, configuration is environment-driven with nothing hardcoded, the theme is a real component system, and the site ships with error and performance monitoring, layered security, accessibility and automated tests. The familiar WordPress admin sits on top; the rigor is underneath.
The Design philosophy carries the same idea to the front end: the theme owns look and feel so editors can focus on content. For the technical specifics, see Architecture.
Where to start
Build & maintain
Architecture, local development, deployment, hosting, caching and security.
Edit content
Add and update providers, locations, page sections and redirects.
Marketing & SEO
SEO, structured data, accessibility and analytics. How the site gets found and measured.
Troubleshoot
Known issues, gotchas and who to contact for what.
What's covered
- Getting oriented — Architecture and Contacts.
- Design — colors, typography and imagery.
- Accessibility — editing habits and color contrast.
- Development — Local setup, the theme & component system, custom post types, adding page sections, the plugin system, data sync, translation, the developer reference and gotchas.
- Content — editing basics, users & access, writing for the web, managing providers, locations and news & articles, and redirects.
- Infrastructure — deployment, hosting, caching, security, operations, monitoring, backups and content sync.
- Measurement — event tracking, conversions, SEO, SEO strategy, local SEO and migration & SEO continuity.
The platform
| Property | Value |
|---|---|
| Production | whallc.com |
| Staging | staging.whallc.com · whallc.joeyyax.dev |
| Stack | WordPress · PHP · MySQL · Redis · Nginx |
| Theme | wha2025 (Tailwind + Laravel Mix, ACF component system) |
| 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.
Developer 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) |