Unit App System Library
Canonical standards, invariants, and implementation doctrine for building Unit product systems.
Source of truthThree pillars, one system
Every Unit module — wallet, vault, identity, future — sits on the same three pillars. Engineers, reviewers, and integrators all read from these surfaces.
How the system is built
Six binding standards across visual, behavioral, and process discipline. UDSP, Preview, Test, Traceability, State Modeling, UI Copy — with practical workflow guidance.
Open guide →Non-negotiable rules for money movement
Send / Deposit / Withdraw differ by funding source — and the rules differ with them. Display ≠ executable. Decimals are sacred. Errors must be safe.
Read invariants →How modules ship
Spec → Build → Preview → Test → Report → Handoff. Case reviews, completion reports, status snapshots, review gates. The repeatable shape of every module delivery.
See protocols →Standards are how the system is built — not documentation after the fact.
If a module can't be previewed, tested, explained, and handed off, it is not complete.
Three audiences, one library
Different roles read this library at different points in the lifecycle. Standards apply identically to all three.
Before coding
- Read the module spec and the invariant map.
- Identify the closed state model and forbidden patterns.
- Pick the correct design tokens; do not invent new ones.
- Plan the preview + test pipeline before writing TSX.
Before approval
- Run the reviewer checklist against the change set.
- Confirm spec → screen → preview → test parity.
- Verify forbidden patterns are absent (grep + assertions).
- Confirm the completion report carries this pass.
Before main-app promotion
- Run the live-codebase alignment audit.
- Map module states to live GraphQL / chain states.
- Confirm decimal precision and fee semantics align.
- Verify role separation (user vs operator) is enforced.
Start here
Standards Implementation
The practical layer — how each standard applies in daily work.
Open →Global Wallet Invariants
The Global Principle and the closed list of forbidden patterns.
Open →Module Delivery Doctrine
Lifecycle, artifacts, review gates, the meaning of "done".
Open →