Examples Overview

machina ships with eight runnable examples covering real-world patterns — from async health checks to React integration to test suite patterns. Each one is a self-contained app you can run locally, and on the deployed docs site they’re live at their own routes.

Examples

Example	What it demonstrates	Key machina features
Connectivity Monitor	Network connectivity tracking with async health checks	createFsm, async in _onEnter, AbortController cleanup in _onExit, custom events
Traffic Intersection	Hierarchical traffic light controller with pedestrian signals	_child delegation, compositeState(), input bubbling, defer(), child auto-reset
Dungeon Critters	Multiple critter instances sharing one FSM definition	createBehavioralFsm, per-client state via WeakMap, shared behavior definition
Shopping Cart	Checkout flow with deferred operations	createFsm, defer(), defer({ until }), lifecycle hooks
Job Queue	Persist/restore pattern with rehydrate() and localStorage	createBehavioralFsm, rehydrate(), silent state restoration, side-effect recovery
With React	React integration for a todo app	createFsm, useSyncExternalStore, framework integration
machina-explorer	Interactive FSM inspector and state diagram visualizer	buildStateGraph, inspectGraph, mermaid stateDiagram-v2, CodeMirror 6
Testing with machina-test	Graph matchers, hierarchical FSM testing, and walkAll runtime testing	machina-test matchers, walkAll, payload generators, seed replay

Try them live

On the deployed docs site, each example is a working app at /demos/{name}/. The doc pages above explain the patterns; the “Run” link at the top of each page opens the live app in a new tab.

During local development, examples run on their own Vite dev server — the docs site doesn’t serve them. See below.

Running locally

# Run any example's dev server
pnpm --filter @machina-examples/connectivity dev

# Or from the example directory
cd examples/connectivity && pnpm dev

Swap connectivity for any of the example names: traffic-intersection, dungeon-critters, shopping-cart, job-queue, with-react, machina-explorer, or testing-with-machina-test.

The testing-with-machina-test example is test-only (no Vite dev server) — run it with pnpm --filter @machina-examples/testing-with-machina-test test.