# pmndrs/its-fine

🐶🔥 A collection of escape hatches for React.

Repository: https://github.com/pmndrs/its-fine
Canonical: https://ross.abutalabs.com/products/its-fine
Homepage: https://npmjs.com/its-fine
Language: TypeScript
License: MIT
License Family: permissive
Topics: fiber, hooks, internal, react, reconciler
Last push: 2025-02-18T15:45:41+00:00

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

## Adoption (not part of the score)
Stars 1183, forks 15 (observed 2026-08-28T04:03:54.523654+00:00)

## What it is
A TypeScript library of escape hatches for React that lets components access the internal React Fiber tree. It provides hooks like useFiber, useContainer, and useContextBridge for building abstractions that modify or extend React's reconciliation behavior.

## Use cases
- access the current component's React Fiber node from within a component
- bridge React context across renderers like react-three-fiber portals
- traverse or query the React Fiber tree from a component
- build custom React abstractions that depend on reconciler internals
- get the react-reconciler container info from a component
- map and inspect context values in the component tree

## When to choose
- you need access to React Fiber internals that React's public API doesn't expose
- you're building a custom React renderer or library like react-three-fiber
- you need to bridge context across renderers or portals
- you're writing tooling or abstractions that inspect the component tree

## When to avoid
- you only need standard React features available through public APIs
- you want to avoid depending on React implementation details that may change between versions
- you're building a simple app with no need for reconciler-level access

## Facets
- artifact type: library
- maturity: stable
- function: ui-components, developer-tools
- domain: frontend, web-development, developer-tools
- platform: browser, cross-platform
- tags: react, react-fiber, hooks, reconciler, context-bridge, typescript, nodejs

## Member repositories
- pmndrs/its-fine (main) score 26

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:54.523654+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-30T06:24:37.994896+00:00, confidence not recorded.
  - readme: https://github.com/pmndrs/its-fine (fetched 2026-08-28T04:03:54.523654+00:00, sha ea586f2d76e3)
  - registry_npm: https://registry.npmjs.org/its-fine (fetched 2026-08-29T12:31:26.376497+00:00, sha f18b06e4c99e)
- Data as of 2026-08-30T08:39:29.467469+00:00.
