Repo brief: statelyai/xstate

Generated by RepoPilot · document generated 2026-09-15 · concise human review Evidence snapshot · analyzed 2026-09-15T16:38:43.135Z · commit a76139b6ed7d

Verdict

Healthy — Healthy across all four use cases

• Last commit today
• 12 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

XState is a zero-dependency TypeScript/JavaScript library for building state machines, statecharts, and actor-based systems to orchestrate complex application logic. It implements the SCXML specification and enables event-driven, predictable state management across frontend and backend applications through a visual, composable actor model. Monorepo using pnpm workspaces: packages/core/src/ contains the state machine engine (StateMachine.ts, StateNode.ts, actors/), packages/core/src/actions/ holds built-in actions (assign, send, spawn), and packages/core/src/graph/ provides path analysis and testing utilities. Additional packages (@xstate/store, etc.) layer on top. Examples and…

Start here

Read these in order:

• packages/core/src/constants.ts — Foundation: doesn't import anything internally and is imported by 10 other files. Read first to learn the vocabulary.
• packages/xstate-store/src/schema.ts — Foundation: imported by 4, no internal dependencies of its own.
• packages/xstate-store/src/types.ts — Built on the foundation; imported by 7 downstream files.
• examples/7guis-flight-booker-react/src/machines/flightMachine.ts — Built on the foundation; imported by 4 downstream files.
• packages/xstate-react/src/useActor.ts — Layer 2 — application-level code that wires the lower layers together.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/statelyai/xstate.git
cd xstate
pnpm install
pnpm test

(Uses pnpm per preconstruct config and preinstall script that enforces it.)

Daily commands:

pnpm build          # Build all packages with preconstruct
pnpm test           # Run full test suite
pnpm test:watch     # Watch mode (vitest)
pnpm test:core      # Test xstate package only
pnpm format         # Format with oxfmt
pnpm lint:fix       # Lint and auto-fix with oxlint

Key cautions & unknowns

• Concentrated ownership — top contributor handles 52% of recent commits
• pnpm requirement: preinstall script enforces pnpm; npm/yarn will fail. Preconstruct config: exports conditions use importConditionDefaultExport and experimental typeModule/distInRoot flags; these affect…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.