# hmans/miniplex

A 👩‍💻 developer-friendly entity management system for 🕹 games and similarly demanding applications, based on 🛠 ECS architecture.

Repository: https://github.com/hmans/miniplex
Canonical: https://ross.abutalabs.com/products/miniplex
Language: TypeScript
License: MIT
License Family: permissive
Topics: ecs, entity-component-system, game-development, state-management, typescript, react
Last push: 2026-04-05T11:12:40+00:00

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

## Adoption (not part of the score)
Stars 1046, forks 45 (observed 2026-08-28T04:03:21.632160+00:00)

## What it is
Miniplex is a developer-friendly entity management system implementing the ECS (Entity Component System) architecture for games and other demanding applications. It is written in TypeScript and includes React integration for building game UIs and interactive applications.

## Use cases
- manage game entities and components with an ECS architecture
- build a game loop with decoupled state and logic
- structure state for a browser-based game in TypeScript
- use ECS entities inside React components
- replace ad-hoc game state management with a component-based system
- build simulations with many entities and efficient queries

## When to choose
- you are building a game or simulation in TypeScript and want an ergonomic ECS
- you want React bindings for rendering ECS-driven state
- you value a small, developer-friendly API over a heavyweight engine

## When to avoid
- you need a full game engine with rendering, physics, and asset pipelines built in
- your project is not in TypeScript/JavaScript
- you need battle-tested ECS performance at massive entity counts with archetype-level optimizations

## Facets
- artifact type: library
- maturity: active
- function: state-management, game-engine
- domain: programming-languages
- platform: browser, cross-platform
- tags: ecs, entity-component-system, react, game-architecture, developer-experience, game-development, typescript, nodejs

## Member repositories
- hmans/miniplex (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:21.632160+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-30T07:01:57.173249+00:00, confidence not recorded.
  - readme: https://github.com/hmans/miniplex (fetched 2026-08-28T04:03:21.632160+00:00, sha af0c08d6f291)
- Data as of 2026-08-30T08:39:29.467469+00:00.