Core concepts
PWFabric is built on a small number of orthogonal concepts. Understand these and the rest of the platform follows naturally.
- Surfaces — The top-level renderable unit. A receipt-materialised composition.
- Blocks — The atomic building units. 45 production blocks across 4 first-party packs.
- Composition — How blocks combine into surfaces and how capabilities enhance them.
- Capabilities — The canonical 5 platform capabilities and the pack bundle model.
- Starters — Pre-composed surface templates ready to copy + customise.
- PhiCo — The authoring composer that proposes Receipts.
- PhiSo — The visitor agent that answers questions on published Surfaces.
- Receipts — The signed, line-numbered contract between PhiCo and you.
- World Blueprint — The provisioning recipe that produces a new World.
Vocabulary at a glance
| Term | What it is |
|---|---|
| World | Per-customer aggregate. Nine canonical elements: identity, blueprint, plan, subscription, preferences, installations, state, economy, entitlements. |
| WorldBlueprint | Provisioning recipe (ADR-125) — turns a plan + signup form into a fully-shaped new World. |
| Surface | A receipt-materialised page. Reproducible, versioned, capability-bound. |
| Receipt | Signed, line-numbered recipe of a surface composition. The contract between PhiCo and you. |
| Block | Atomic building unit. Typed, manifest-described, schema-validated. |
| Atom | Unit of composition shipped in PWPacks. |
| Capability | Platform-level power a surface can declare (platform/input, platform/persistence, etc.). |
| PhiCo | Authoring composer — proposes Receipts. |
| PhiSo | Visitor surface operator — reads published surfaces, answers questions. |
| PWPack | The publishing format for blocks, capabilities, and surfaces. |