What is the difference between getPersistedSnapshot and getSnapshot?

getPersistedSnapshot() captures the internal state required for full restoration, whereas getSnapshot() only returns the last emitted value intended for UI subscribers.

When should I use event sourcing instead of snapshots?

Use event sourcing when you need a full audit trail, when your machine logic changes frequently (making old snapshots incompatible), or when you need side effects to re-run during reconstruction.

Are entry actions re-executed upon state restoration?

No, entry and exit actions for the state being restored are not re-executed because the machine assumes these actions were already performed before the state was saved.

Does XState persistence handle nested child actors?

Yes, persisting a parent actor via getPersistedSnapshot() automatically includes the state of all invoked and spawned children recursively.

What data can be persisted in an XState machine?

Only JSON-serializable data can be persisted. You cannot save functions, class instances, symbols, or circular references within the context or state.

XState State Persistence

Name: XState State Persistence
Author: IlyaGulya

byIlyaGulya

0•

開発者ツール

Simplifies saving and restoring XState v5 actor states across various storage mediums and hierarchies.

This skill provides comprehensive patterns and implementation guides for managing state persistence in XState v5. It covers essential techniques such as serializing actor snapshots with getPersistedSnapshot, implementing recursive restoration for complex parent-child actor hierarchies, and utilizing event sourcing for auditable state replay. It is particularly useful for developers building offline-first applications, long-running backend workflows, or complex frontend interfaces that must maintain consistency across page refreshes or session interruptions.

主な機能

01Includes auto-persist subscription patterns for real-time storage synchronization

02Supports deep persistence for nested invoked and spawned actor hierarchies

03Provides patterns for partial state restoration using resolveState

04Implements XState v5 snapshot-based persistence and restoration

050 GitHub stars

06Demonstrates event sourcing techniques for state replay and auditing

ユースケース

01Resuming long-running backend workflows or multi-step processes from a database

02Implementing undo/redo functionality or state debugging through event logs

03Restoring complex UI form states after a browser refresh or session timeout

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ilyagulya/claude-marketplace xstate-persistence

For use in Claude.ai and ChatGPT

Download Skill