CultLib/src/GameCult.Mesh/docs/getting-started
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-14 23:13:13 +01:00
..
01-persist-typed-state.md Start CultMesh and Eve getting started series 2026-07-12 20:52:43 +01:00
02-connect-by-identity.md Bind live typed documents through CultMesh client 2026-07-12 21:03:55 +01:00
03-publish-an-eve-surface.md Start CultMesh and Eve getting started series 2026-07-12 20:52:43 +01:00
04-keep-a-typescript-provider-alive.md Add durable TypeScript provider sessions 2026-07-14 23:13:13 +01:00
README.md Add durable TypeScript provider sessions 2026-07-14 23:13:13 +01:00

CultMesh And Eve Getting Started

This series builds one typed application state and presents it through multiple Eve runtimes. It is maintained as an API acceptance test: examples use public APIs, name the owner of each decision, and include a verification checkpoint.

Follow the chapters in order:

  1. Persist typed application state
  2. Connect a client by stable identity
  3. Publish one Eve surface to multiple runtimes
  4. Keep a TypeScript provider alive

The intended application shape is small:

provider daemon -> typed CultCache documents -> CultMesh advertisement
                                               |
                      +------------------------+--------------------+
                      |                        |                    |
                 Eve browser              EveUnity          another lowerer

The provider owns live truth. Eve owns the surface contract. Each runtime owns native projection. CultMesh owns discovery and connection continuity.

Maintenance Contract

  • A chapter must not tell an application to choose physical endpoints, build a reconnect loop, or duplicate provider state.
  • Code must compile against the package version named by the release that publishes it.
  • Every release changing a demonstrated API must update this series in the same pull request.
  • A setup step that depends on repository internals is an API defect, not acceptable tutorial folklore.