XMachines Guides

Entry points for the current XMachines Play architecture.

Start Here

• Installation — Core packages, framework-specific additions, TypeScript config, ESM setup
• Getting Started — setup().createMachine() → definePlayer() → actor.start() → TC39 Signals

Concepts

Background reading that explains the why behind XMachines design decisions. Read these when you want to understand the architecture, not just use the API.

• Understanding State Machines — What finite state machines are, how meta.route and meta.view extend them, and why they replace boolean flags, scattered guards, and component-level routing logic
• Understanding the Actor Model — The actor/infrastructure split, what AbstractActor enforces, 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 five architectural invariants they enforce