This page documents the shared systems behind Sunbeam: what exists, how the pieces depend on one another, and what is still only planned. Links point to the relevant source code and technical notes.
The systems are listed in dependency order. Solid rows have an implementation today; dashed rows describe areas that have not been implemented.
Dependencies run from bottom to top: applications rely on administration, which relies on identity.
The identity layer. Passport issues Ed25519-signed tokens, publishes verification keys at /.well-known/jwks.json, supports offline verification, and records changes in an append-only ledger. Document numbers include check digits.
The administration and authentication layer. It manages invitations, people, and roles. Sunbeam applications integrate through their own client credentials rather than receiving access to signing keys.
Shared infrastructure is kept in public repositories so its implementation and history can be inspected.
Use established formats and protocols where possible, including OAuth 2.1, OpenID Connect, and Ed25519-signed JWTs.
Publish the information required for verification and avoid a network dependency when an offline check is sufficient.
Use append-only ledgers or revision histories for important state changes instead of replacing the previous record.
Scope: Passport, OS, and Docs are the only layers with code today. Treasury, governance, and physical access describe intended areas of work, not committed delivery dates.
Project directory
Other Sunbeam projects. These are not infrastructure dependencies unless they are listed in the system index above.
Availability and source status vary by project. Public repositories are listed at github.com/sunbeam-za.