jakesgordon/javascript-state-machine

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

8750 stars · 946 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

A JavaScript finite state machine library for defining states, transitions, and lifecycle event hooks. It works in both the browser and Node.js and generates transition methods and observer callbacks from a declarative config.

Use cases

• model game or UI object states with explicit transitions
• implement a workflow with allowed state changes and guards
• replace ad-hoc boolean flags with a state machine
• add lifecycle hooks when an object changes state
• manage states like solid/liquid/gas or idle/running/paused in JavaScript

When to choose

• you need a lightweight, dependency-free finite state machine in JavaScript
• you want declarative transitions with automatic transition methods and event observers
• you need the same state machine logic in browser and Node.js

When to avoid

• you need hierarchical or concurrent statecharts (e.g. XState)
• your project is not JavaScript/Node.js based
• you need persistence or distributed state machine orchestration

Facets

library · maturity stable

state-management developer-tools web-development frontend browser cross-platform finite-state-machine fsm state-transitions lifecycle-events javascript algorithms nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="jakesgordon/javascript-state-machine")