Reference Implementations

Repo Role Status
workpads-standard Normative specification (this site) v0.1 live
workpads-codec @workpads/codec npm package — implements §5 v0.1
workpads-cli CLI reference implementation — implements §4 surface, used for integration testing v0.x
workpadsdev-cli Developer toolchain — build, packaging, softkey validation, conformance checks v0.1
workpadskaios KaiOS 3.x reference app — full implementation, D-pad navigation v0.1
workpadsdotme Web reference app (workpads.me) — three-column layout, mouse + keyboard active
workpads-basicsconform Research control plane — quiz rounds, decision log, deviation registry internal
workpads Original architecture documents (pre-2026). Historical reference. archived

Products

Site Purpose
workpads.org Main project site — app overview, onboarding, KaiOS launch
workpads.app Web app
workpads.me Web reference app (three-column layout)
standard.workpads.org This site — normative standard documentation

How the Ecosystem Connects

The codec (workpads-codec) is the shared library. Both workpadskaios and workpadsdotme depend on it for §5 encoding and decoding. The CLI uses the same codec for integration testing.

workpads-standard (this repository) is the authority. When any implementation conflicts with the standard, the standard governs. Implementations document deviations rather than silently diverging.

See ECOSYSTEM.md in the standard repo for a detailed description of each repo’s role and interconnections.


Build Your Own

The standard is open. Independent implementations — experimental apps, open-source tools, proprietary products — are welcome. The standard defines what a workpad record is and how it is encoded. What you build with that is yours.

Read the contribution guide →