Skip to content
XMachines

XMachines Guides

User-facing guides for the XMachines Play architecture.

Start Here

  • Getting Started — Installation, first actor, routing, router adapters, and view renderers

Concepts

Background reading that explains the why behind XMachines design decisions.

  • Understanding State Machines — What finite state machines are, how meta.route and meta.view extend them, and why they replace boolean flags and component-level routing logic
  • Understanding the Actor Model — The actor/infrastructure split, why the machine has zero framework imports, and how the reset invariant works
  • Understanding TC39 Signals — The three signal primitives (Signal.State, Signal.Computed, Signal.subtle.Watcher), why XMachines uses them instead of observables, and the architectural invariants they enforce