# software-mansion/react-freeze

Prevent React component subtrees from rendering.

Repository: https://github.com/software-mansion/react-freeze
Canonical: https://ross.abutalabs.com/products/react-freeze
Homepage: https://www.npmjs.com/package/react-freeze
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-06-01T12:16:43+00:00

## Health v2 (maintenance only)
Score: 61/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 85, release rhythm 8, longevity 100
- inputs: {"age_days": 1787, "days_push": 93, "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 1654, forks 43 (observed 2026-08-28T04:05:17.178767+00:00)

## What it is
A small React library that prevents component subtrees from rendering by leveraging the Suspense mechanism. Frozen components are not unmounted, so their state and native view instances (DOM elements or React Native views) are preserved while hidden.

## Use cases
- prevent hidden React Native screens from re-rendering
- freeze off-screen components to save reconciliation work
- keep scroll position and input state while a screen is covered
- stop redux store updates from re-rendering invisible views
- optimize stack navigation performance in React Native apps
- suspend rendering of parts of a React component tree

## When to choose
- you use React Navigation in React Native and want to skip re-renders of hidden screens
- you need to preserve component state and native views while hiding UI
- you want to reduce unnecessary React computation for invisible subtrees

## When to avoid
- you need hidden components to actually unmount and free resources
- your React version predates Suspense support (React 17+ required)
- you need to freeze components in ways incompatible with Suspense semantics

## Facets
- artifact type: library
- maturity: stable
- function: state-management, ui-components
- domain: frontend, web-development, mobile-development, performance
- platform: cross-platform
- tags: react, suspense, render-optimization, react-navigation, performance-optimization, react-native, web

## Member repositories
- software-mansion/react-freeze (main) score 61

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:17.178767+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-30T03:44:56.802495+00:00, confidence not recorded.
  - readme: https://github.com/software-mansion/react-freeze (fetched 2026-08-28T04:05:17.178767+00:00, sha 8b5a303c8d6e)
  - registry_npm: https://registry.npmjs.org/react-freeze (fetched 2026-08-29T11:18:04.762110+00:00, sha 7c8b3b37e86f)
- Data as of 2026-08-30T08:39:29.467469+00:00.