An open, structured format for wellness plans.
WPL is a JSON-based language for describing comprehensive wellness programs that include workouts, nutrition, meditation, recovery, and habits. It enables platforms, trainers, and AI systems to create, validate, personalize, and track wellness plans consistently.
This repository is the source of truth for the WPL specification, JSON Schema, and conformance test suite.
- 📖 Specification
- 📐 JSON Schema (canonical URL:
https://wpl.dev/schemas/wpl/v1.schema.json) - 📦 Examples
- 🧪 Conformance suite
- 🌐 wpl.dev — language website + interactive playground
Reference validators (consume the schema and conformance suite from this repo):
| Language | Repo | Package |
|---|---|---|
| TypeScript | gymbile/wpl-validator-ts |
@gymbile/wpl-validator (npm) |
| Elixir | gymbile/wpl-validator-ex |
wpl_validator (hex) |
Both implementations must produce identical results for the conformance suite.
The WPL schema follows semver. The canonical schema URL stays at /v1.schema.json for the entire v1 line — additive changes only. A breaking change becomes /v2.schema.json at a new URL; existing v1 plans keep working.
This repository uses split licensing:
| Path | License |
|---|---|
spec/, examples/ |
CC-BY-4.0 — documentation, free to use with attribution |
schema/, conformance/, .github/ |
Apache-2.0 — code, with patent grant |
"WPL" and "Wellness Plan Language" are trademarks of Gymbile. The spec and reference implementations are open under the licenses above. Implementations may declare conformance ("WPL-compatible" or "WPL v1 compliant") but may not be named "WPL" or imply endorsement by Gymbile. Forks must rename.
An implementation that passes every fixture in conformance/ may declare itself "WPL v1 compliant." See conformance/README.md for details.
See CONTRIBUTING.md.