# Documentation

- [Stately & XState docs](/docs)
- Get started
- Core concepts
- Stately Studio
  - Design mode
  - Simulate mode
  - Code
  - Stately Sky
  - Share
  - Accounts
- Actors
- Agents
  - [AI agents](/docs/agents/agents): Author AI agents as typed XState state machines with @statelyai/agent.
- Guides
- Packages
  - [Packages](/docs/packages)
- Developer tools
- [Glossary](/docs/glossary)
- [Self-hosting](/docs/self-hosting): Run the Stately editor in your own environment, embed it in a host app, and choose the auth, API, AI, and comments boundaries for an internal deployment.

## Complete page index
- [Actions](/docs/actions.mdx)
- [The Actor model](/docs/actor-model.mdx)
- [Actors](/docs/actors.mdx)
- [Notes](/docs/annotations.mdx)
- [Assets in Stately’s editor](/docs/assets.mdx)
- [Autolayout](/docs/autolayout.mdx)
- [Callback Actors](/docs/callback-actors.mdx)
- [Canvas controls](/docs/canvas-view-controls.mdx)
- [Cheatsheet](/docs/cheatsheet.mdx)
- [Colors](/docs/colors.mdx)
- [Context](/docs/context.mdx)
- [Delayed (after) transitions](/docs/delayed-transitions.mdx)
- [Descriptions](/docs/descriptions.mdx)
- [Design mode](/docs/design-mode.mdx)
- [Developer tools](/docs/developer-tools.mdx)
- [Discover](/docs/discover.mdx)
- [Actions and actors in Stately’s editor](/docs/editor-actions-and-actors.mdx)
- [Context and meta in Stately’s editor](/docs/editor-context-and-meta.mdx)
- [States and transitions in Stately’s editor](/docs/editor-states-and-transitions.mdx)
- [Tags in Stately’s editor](/docs/editor-tags.mdx)
- [Embed machines using their embed URL](/docs/embed.mdx)
- [Event emitter](/docs/event-emitter.mdx)
- [Eventless (always) transitions](/docs/eventless-transitions.mdx)
- [XState examples](/docs/examples.mdx)
- [Export as code](/docs/export-as-code.mdx)
- [Embed Figma](/docs/figma.mdx)
- [Final states](/docs/final-states.mdx)
- [Finite states](/docs/finite-states.mdx)
- [Function Actors](/docs/function-actors.mdx)
- [Generate with AI](/docs/generate-flow.mdx)
- [Generate React app](/docs/generate-react.mdx)
- [Generate test paths](/docs/generate-test-paths.mdx)
- [Graph & Paths](/docs/graph.mdx)
- [Guards](/docs/guards.mdx)
- [History states](/docs/history-states.mdx)
- [Share machine images using their image URL](/docs/image.mdx)
- [Usage with Immer](/docs/immer.mdx)
- [Import from code](/docs/import-from-code.mdx)
- [Connect GitHub repo](/docs/import-from-github.mdx)
- [Initial states](/docs/initial-states.mdx)
- [Input](/docs/input.mdx)
- [Inspection](/docs/inspection.mdx)
- [Inspector](/docs/inspector.mdx)
- [Installation](/docs/installation.mdx)
- [Invoke](/docs/invoke.mdx)
- [Keyboard shortcuts](/docs/keyboard-shortcuts.mdx)
- [Live simulation mode](/docs/live-simulation.mdx)
- [Lock machines](/docs/lock-machines.mdx)
- [Machine restore](/docs/machine-restore.mdx)
- [State machines](/docs/machines.mdx)
- [Migrating from XState v4 to v5](/docs/migration.mdx)
- [Observable Actors](/docs/observable-actors.mdx)
- [Output](/docs/output.mdx)
- [Parallel states](/docs/parallel-states.mdx)
- [Parent states](/docs/parent-states.mdx)
- [Persistence](/docs/persistence.mdx)
- [Projects](/docs/projects.mdx)
- [Promise actors](/docs/promise-actors.mdx)
- [Pure transition functions](/docs/pure-transitions.mdx)
- [Quick start](/docs/quick-start.mdx)
- [Routes](/docs/routes.mdx)
- [Setup](/docs/setup.mdx)
- [Sign up for Stately Studio](/docs/sign-up.mdx)
- [Simulate mode](/docs/simulate-mode.mdx)
- [Sources](/docs/sources.mdx)
- [Spawn](/docs/spawn.mdx)
- [State done events](/docs/state-done-events.mdx)
- [State machine actors](/docs/state-machine-actors.mdx)
- [What are state machines and statecharts?](/docs/state-machines-and-statecharts.mdx)
- [Stately Sky getting started](/docs/stately-sky-getting-started.mdx)
- [State](/docs/states.mdx)
- [Stately Studio API](/docs/studio-api.mdx)
- [Stately Studio Free plan](/docs/studio-community-plan.mdx)
- [Stately Studio Enterprise plan](/docs/studio-enterprise-plan.mdx)
- [Stately Studio Pro plan](/docs/studio-pro-plan.mdx)
- [Stately Studio Team plan](/docs/studio-team-plan.mdx)
- [Stately Studio](/docs/studio.mdx)
- [Systems](/docs/system.mdx)
- [Tags](/docs/tags.mdx)
- [Teams](/docs/teams.mdx)
- [Templates](/docs/templates.mdx)
- [Testing](/docs/testing.mdx)
- [Transition Actors](/docs/transition-actors.mdx)
- [Events and transitions](/docs/transitions.mdx)
- [Typegen](/docs/typegen.mdx)
- [TypeScript](/docs/typescript.mdx)
- [Upgrade your Stately Studio account](/docs/upgrade.mdx)
- [Share machines using their share URL](/docs/url.mdx)
- [User preferences](/docs/user-preferences.mdx)
- [Version history](/docs/versions.mdx)
- [Visualizer (deprecated)](/docs/visualizer.mdx)
- [@xstate/fsm](/docs/xstate-fsm.mdx)
- [@xstate/graph](/docs/xstate-graph.mdx)
- [@xstate/immer](/docs/xstate-immer.mdx)
- [@xstate/react](/docs/xstate-react.mdx)
- [@xstate/store](/docs/xstate-store-v2.mdx)
- [@xstate/store v3](/docs/xstate-store-v3.mdx)
- [@xstate/store](/docs/xstate-store.mdx)
- [@xstate/svelte](/docs/xstate-svelte.mdx)
- [@xstate/test](/docs/xstate-test.mdx)
- [XState VS Code extension](/docs/xstate-vscode-extension.mdx)
- [@xstate/vue](/docs/xstate-vue.mdx)
- [XState](/docs/xstate.mdx)
- [@xstate/store-angular](/docs/xstate-store/angular.mdx)
- [Compare to Jotai](/docs/xstate-store/compare-jotai.mdx)
- [Compare to Pinia](/docs/xstate-store/compare-pinia.mdx)
- [Compare to Recoil](/docs/xstate-store/compare-recoil.mdx)
- [Compare to Redux](/docs/xstate-store/compare-redux.mdx)
- [Compare to Zustand](/docs/xstate-store/compare-zustand.mdx)
- [Migrating to v4](/docs/xstate-store/migration.mdx)
- [Persist](/docs/xstate-store/persist.mdx)
- [@xstate/store-preact](/docs/xstate-store/preact.mdx)
- [@xstate/store-react](/docs/xstate-store/react.mdx)
- [Reset](/docs/xstate-store/reset.mdx)
- [@xstate/store-solid](/docs/xstate-store/solid.mdx)
- [@xstate/store-svelte](/docs/xstate-store/svelte.mdx)
- [Undo/redo](/docs/xstate-store/undo-redo.mdx)
- [Validate schemas](/docs/xstate-store/validate-schemas.mdx)
- [@xstate/store-vue](/docs/xstate-store/vue.mdx)
- [@xstate/store-angular](/docs/xstate-store-v3/angular.mdx)
- [@xstate/store-preact](/docs/xstate-store-v3/preact.mdx)
- [@xstate/store-react](/docs/xstate-store-v3/react.mdx)
- [@xstate/store-solid](/docs/xstate-store-v3/solid.mdx)
- [@xstate/store-svelte](/docs/xstate-store-v3/svelte.mdx)
- [@xstate/store-vue](/docs/xstate-store-v3/vue.mdx)
- [Use in any stack](/docs/packages/agent/any-stack.mdx)
- [Choosing a run mode](/docs/packages/agent/choosing-a-run-mode.mdx)
- [Debugging](/docs/packages/agent/debugging.mdx)
- [Decisions](/docs/packages/agent/decisions.mdx)
- [Evals](/docs/packages/agent/evals.mdx)
- [The event log](/docs/packages/agent/event-log.mdx)
- [Migrating from a hand-rolled loop](/docs/packages/agent/from-a-loop.mdx)
- [Generating machines with an LLM](/docs/packages/agent/generate-machines.mdx)
- [Hosts and executors](/docs/packages/agent/hosts.mdx)
- [Human in the loop](/docs/packages/agent/human-in-the-loop.mdx)
- [Agents](/docs/packages/agent.mdx)
- [Coming from LangGraph](/docs/packages/agent/langgraph-comparison.mdx)
- [Machines as data](/docs/packages/agent/machines-as-data.mdx)
- [Preset machines](/docs/packages/agent/machines-presets.mdx)
- [Agent machines](/docs/packages/agent/machines.mdx)
- [Messages](/docs/packages/agent/messages.mdx)
- [Models and providers](/docs/packages/agent/models-and-providers.mdx)
- [Multi-agent composition](/docs/packages/agent/multi-agent.mdx)
- [Observability](/docs/packages/agent/observability.mdx)
- [Agent patterns](/docs/packages/agent/patterns.mdx)
- [Where state lives](/docs/packages/agent/persistence.mdx)
- [Quickstart](/docs/packages/agent/quickstart.mdx)
- [Post-alpha roadmap](/docs/packages/agent/roadmap.mdx)
- [Scope and ecosystem boundaries](/docs/packages/agent/scope.mdx)
- [The step path](/docs/packages/agent/steps.mdx)
- [Text requests](/docs/packages/agent/text-requests.mdx)
- [Thinking in state machines](/docs/packages/agent/thinking-in-state-machines.mdx)
- [Tools](/docs/packages/agent/tools.mdx)
- [Usage and budgets](/docs/packages/agent/usage-and-budgets.mdx)
- [Testing and verification](/docs/packages/agent/verify.mdx)
- [@statelyai/graph](/docs/packages/graph.mdx)
- [Algorithms reference](/docs/packages/graph/algorithms.mdx)
- [Benchmarks](/docs/packages/graph/benchmarks.mdx)
- [Layout transitions](/docs/packages/graph/layout-transitions.mdx)
- [Layout](/docs/packages/graph/layout.mdx)
- [Migrating from @dagrejs/graphlib](/docs/packages/graph/migrating-from-graphlib.mdx)
- [React Flow + ELK: automatic layout cookbook](/docs/packages/graph/react-flow-elk-pipeline.mdx)
- [Scaling & Plugin Architecture](/docs/packages/graph/scaling-and-plugins.mdx)
- [Actions](/docs/xstate/v6/actions.mdx)
- [Actor logic](/docs/xstate/v6/actor-logic.mdx)
- [Actors](/docs/xstate/v6/actors.mdx)
- [Async logic](/docs/xstate/v6/async-logic.mdx)
- [Handle async requests](/docs/xstate/v6/async-requests.mdx)
- [Run backend workflows](/docs/xstate/v6/backend-workflows.mdx)
- [Cancel async work](/docs/xstate/v6/cancellation.mdx)
- [Choose XState](/docs/xstate/v6/choose-xstate.mdx)
- [Machine configuration](/docs/xstate/v6/configuration.mdx)
- [Context](/docs/xstate/v6/context.mdx)
- [Create actors](/docs/xstate/v6/create-actor.mdx)
- [Data and effects](/docs/xstate/v6/data-and-effects.mdx)
- [Delays](/docs/xstate/v6/delays.mdx)
- [Contributing documentation](/docs/xstate/v6/documentation.mdx)
- [Final, history and parallel states](/docs/xstate/v6/final-history-parallel.mdx)
- [Build forms and wizards](/docs/xstate/v6/forms-and-wizards.mdx)
- [Glossary](/docs/xstate/v6/glossary.mdx)
- [Guards](/docs/xstate/v6/guards.mdx)
- [Input and output](/docs/xstate/v6/input-output.mdx)
- [Inspect actor systems](/docs/xstate/v6/inspect-actor-systems.mdx)
- [Inspection](/docs/xstate/v6/inspection.mdx)
- [Invoke actors](/docs/xstate/v6/invoke.mdx)
- [Lifecycle and errors](/docs/xstate/v6/lifecycle-and-errors.mdx)
- [Model application behavior](/docs/xstate/v6/modeling.mdx)
- [Persist and restore actors](/docs/xstate/v6/persist-and-restore-actors.mdx)
- [Persistence](/docs/xstate/v6/persistence.mdx)
- [Quick start](/docs/xstate/v6/quick-start.mdx)
- [Add retries and timeouts](/docs/xstate/v6/retries-and-timeouts.mdx)
- [Actor snapshots](/docs/xstate/v6/snapshots.mdx)
- [Spawn actors](/docs/xstate/v6/spawn.mdx)
- [Statecharts](/docs/xstate/v6/statecharts.mdx)
- [States, events and transitions](/docs/xstate/v6/states-events-transitions.mdx)
- [States](/docs/xstate/v6/states.mdx)
- [Actor systems](/docs/xstate/v6/systems.mdx)
- [Test XState logic](/docs/xstate/v6/testing.mdx)
- [Transitions](/docs/xstate/v6/transitions.mdx)
- [Troubleshooting](/docs/xstate/v6/troubleshooting.mdx)
- [TypeScript](/docs/xstate/v6/typescript.mdx)
- [Utilities](/docs/xstate/v6/utilities.mdx)
- [Why state machines?](/docs/xstate/v6/why-state-machines.mdx)
- [Migrate from XState v5 to v6](/docs/xstate/v6/xstate-v5-to-v6.mdx)
- [Your first machine](/docs/xstate/v6/your-first-machine.mdx)
- [Input and restored snapshots](/docs/xstate/v6/react/input-and-snapshots.mdx)
- [Select actor data](/docs/xstate/v6/react/selectors.mdx)
- [Server rendering](/docs/xstate/v6/react/server-rendering.mdx)
- [Share actors](/docs/xstate/v6/react/shared-actors.mdx)
- [Use a machine in React](/docs/xstate/v6/react/use-machine.mdx)
- [Input and restored snapshots](/docs/xstate/v6/solid/input-and-snapshots.mdx)
- [Select actor data](/docs/xstate/v6/solid/selectors.mdx)
- [Server rendering](/docs/xstate/v6/solid/server-rendering.mdx)
- [Share actors](/docs/xstate/v6/solid/shared-actors.mdx)
- [Use a machine in Solid](/docs/xstate/v6/solid/use-machine.mdx)
- [Effects and emitted events](/docs/xstate/v6/store/effects-and-emitted-events.mdx)
- [Events and context](/docs/xstate/v6/store/events-and-context.mdx)
- [Framework bindings](/docs/xstate/v6/store/frameworks.mdx)
- [Migration](/docs/xstate/v6/store/migration.mdx)
- [Persistence](/docs/xstate/v6/store/persistence.mdx)
- [Quick start](/docs/xstate/v6/store/quick-start.mdx)
- [Selectors](/docs/xstate/v6/store/selectors.mdx)
- [TypeScript](/docs/xstate/v6/store/typescript.mdx)
- [Undo and redo](/docs/xstate/v6/store/undo-redo.mdx)
- [Input and restored snapshots](/docs/xstate/v6/svelte/input-and-snapshots.mdx)
- [Select actor data](/docs/xstate/v6/svelte/selectors.mdx)
- [Server rendering](/docs/xstate/v6/svelte/server-rendering.mdx)
- [Share actors](/docs/xstate/v6/svelte/shared-actors.mdx)
- [Use a machine in Svelte](/docs/xstate/v6/svelte/use-machine.mdx)
- [Input and restored snapshots](/docs/xstate/v6/vue/input-and-snapshots.mdx)
- [Select actor data](/docs/xstate/v6/vue/selectors.mdx)
- [Server rendering](/docs/xstate/v6/vue/server-rendering.mdx)
- [Share actors](/docs/xstate/v6/vue/shared-actors.mdx)
- [Use a machine in Vue](/docs/xstate/v6/vue/use-machine.mdx)
- [@statelyai/sdk](/docs/packages/sdk.mdx)
- [statelyai](/docs/packages/cli.mdx)
- [Stately MCP](/docs/packages/mcp.mdx)

## Optional
- [Full documentation](/llms-full.txt): Complete docs in one file