# thefrontside/microstates

Composable state primitives for JavaScript

Repository: https://github.com/thefrontside/microstates
Canonical: https://ross.abutalabs.com/products/microstates
Language: JavaScript
License Family: other
Topics: composition, state-machines, lens, microstates, transition, batch-transitions
Last push: 2023-03-04T03:29:16+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3722, "days_push": 1278, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1303, forks 46 (observed 2026-08-28T04:04:18.319601+00:00)

## What it is
Microstates is a JavaScript library providing composable state primitives that let you work with immutable data through pure functions while feeling like mutable models. It supports type composition, transitions, state machines, and framework integrations.

## Use cases
- manage immutable application state with a mutable-style API
- model state machines with explicit transitions
- compose complex state types from simple primitives
- share state logic across different frontend frameworks
- chain state transitions over nested data structures

## When to choose
- you want immutable state updates without boilerplate spread operators
- you need composable, reusable state models in plain JavaScript
- you want framework-agnostic state primitives with observable streams

## When to avoid
- you need a library with active development and recent commits
- you're on React and prefer mainstream solutions like Redux or Zustand
- you need TypeScript-first type safety

## Facets
- artifact type: library
- maturity: maintenance
- function: state-management, serialization
- domain: web-development, frontend, developer-tools
- platform: browser
- tags: immutable-data, state-machines, lenses, functional-programming, composable-state, nodejs, javascript

## Member repositories
- thefrontside/microstates (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:18.319601+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:51:14.092487+00:00, confidence not recorded.
  - readme: https://github.com/thefrontside/microstates (fetched 2026-08-28T04:04:18.319601+00:00, sha 87de375bc765)
- Data as of 2026-08-30T08:39:29.467469+00:00.