WHS Factory
A client-agnostic engine that builds complete, branded Work Health & Safety management systems on demand — the productised version of a proven hand-built delivery, turned into something repeatable from a single config file.
The problem
Building a full WHS management system for one client is weeks of work — manual, forms, worker guides, a hosted site, all branded and internally consistent. Doing it again for the next client means repeating almost all of it by hand.
The approach
WHS Factory extracts the production patterns from a gold-standard build into a
parameterised engine. Point it at a client's existing manual (or start from the
reference skeleton), and it auto-brands and generates the entire bundle from a single
client.yaml — no code changes per client.
- Ingests a client's existing WHS manual and maps content to a standard structure
- Extracts brand palette from the client's logo and website
- Generates manual (docx/pdf), forms, worker quick-guides, and a searchable site
- Validates output against locked format contracts to prevent drift
- Deploys to Cloudflare Pages with Zero Trust access gates as infrastructure-as-code
Stack
Python document generation (python-docx, Pandoc), YAML-driven configuration, MkDocs for the site, and Terraform for Cloudflare Pages hosting and access control.