xstate-migrate

JSON →
library 0.0.8 ·javascript
verified Jun 7, 2026

xstate-migrate (v0.0.8) is a migration library for persisted XState machines, enabling seamless transitions between different versions of state machine configurations. It generates JSON Patch operations that describe changes needed to update a persisted snapshot (context and state) to match a new machine definition. Supports nested/parallel state machines and context property additions/removals. Requires XState v5.28+ as a peer dependency. Key differentiator: automates migration generation via comparison of initial snapshots, preserving existing context values. Currently in early development (0.x), with TypeScript types included.