0.7.0
GitHub

The guide

The guide

Keep your data true on devices, at the edge and in the cloud: where to start, what to build, and how it works. Every Rust example in it is checked by the repository's tests.

Start from what you want

  • See it work. Your first encounter: three short programs that end with the store refusing a write that would have broken a rule.
  • Plan your app. Choose a topology: where each log, view and decision lives across devices, the edge and the cloud.
  • Pick a database. Choose a store: SQLite, Postgres, Neon or a Durable Object, and what each one refuses.
  • Run at the edge. Run on a Durable Object: the event store inside Cloudflare, next to your users.

By pillar

You want your data to stay…Read
True offlineChoose a topology, then Sync a device to a central store
True to your rulesAppending under a condition, carrying your rule into your domain, retrying a command safely
True to its historyRebuilding a read model, the worked example
True wherever it livesChoose a store, run on a Durable Object, bring your own store

New to event sourcing?

Four short background pages, each ending with a link to the next. Read them if the pages above use words you have not met.

  1. Events, and the systems built on them: what an event is, and why systems are built around them.
  2. Event sourcing, and CQRS: what changes when the events become the record.
  3. Aggregates, and the boundary drawn in advance: how most event-sourced systems keep decisions safe, and where that runs out.
  4. Dynamic consistency boundaries: how happenstance checks a rule across as many records as it needs.

Everything else

Every page states, under its title, the one question it answers, and the menu groups them by what you want to do: understand an idea, learn by running code, or get a specific job done. The reference says what is checked and where, and the API documents every public item.

The pages live in the repository's docs/ directory, and this site renders them unchanged: an example that stopped compiling would fail the build before it reached you.

Learn

Find your way

Understand

Do