# ianstormtaylor/react-values

A set of tiny React components for handling state with render props.

Repository: https://github.com/ianstormtaylor/react-values
Canonical: https://ross.abutalabs.com/products/react-values
Homepage: https://git.io/react-values
Language: JavaScript
License: MIT
License Family: permissive
Topics: react, components, state-management, render-props, headless
Archived: true
Last push: 2019-03-05T10:55:57+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2977, "days_push": 2738, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1006, forks 31 (observed 2026-08-28T04:03:11.797726+00:00)

## What it is
A set of tiny, composable React components for handling state via render props. It provides typed value helpers (Boolean, Number, Array, Map, etc.) exposing transforms like toggle, increment, and filter to build stateful UI primitives.

## Use cases
- manage toggle state in react without rewriting boolean logic
- build a counter component with increment and decrement
- handle array state like push and filter in react components
- create headless dropdowns popovers and tooltips
- avoid reimplementing state management logic for common value types

## When to choose
- you use render props and want tiny composable state helpers
- you keep rewriting toggle, increment, or array mutation logic
- you want headless, unstyled state primitives for custom UIs

## When to avoid
- you use modern React hooks, which cover most of these cases
- you need a maintained library - the latest release is from 2019
- you prefer a full state management solution like Redux or Zustand

## Facets
- artifact type: library
- maturity: maintenance
- function: state-management, ui-components
- domain: frontend, web-development, developer-tools
- platform: browser, cross-platform
- tags: react, render-props, headless-components, javascript, nodejs

## Member repositories
- ianstormtaylor/react-values (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:11.797726+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:12:46.703206+00:00, confidence not recorded.
  - readme: https://github.com/ianstormtaylor/react-values (fetched 2026-08-28T04:03:11.797726+00:00, sha aae4b7d7b672)
  - homepage: https://git.io/react-values (fetched 2026-08-29T13:12:59.007247+00:00, sha 956823c63eef)
  - registry_npm: https://registry.npmjs.org/react-values (fetched 2026-08-29T13:12:59.016208+00:00, sha d2160a9a1f03)
- Data as of 2026-08-30T08:39:29.467469+00:00.
