# callstack/react-native-testing-library

🦉 Simple and complete React Native testing utilities that encourage good testing practices.

Repository: https://github.com/callstack/react-native-testing-library
Canonical: https://ross.abutalabs.com/products/react-native-testing-library
Homepage: https://oss.callstack.com/react-native-testing-library/
Language: TypeScript
License: MIT
License Family: permissive
Topics: testing, react, react-native, jest
Last push: 2026-08-13T08:22:20+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 90, longevity 100
- inputs: {"age_days": 2893, "days_push": 20, "days_rel": 71, "gap_med": 8.5, "n_releases_24m": 19}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3413, forks 280 (observed 2026-08-28T04:08:03.503513+00:00)

## What it is
React Native Testing Library is a TypeScript library providing simple and complete testing utilities for React Native components, built on top of Test Renderer. It encourages testing through user-facing behavior rather than implementation details, offering render, queries, Jest matchers, and user event simulation APIs.

## Use cases
- test react native components
- simulate user interactions like typing and pressing in react native tests
- write maintainable component tests that survive refactors
- query rendered ui by role, label, or test id
- test react hooks with renderHook
- add jest matchers for react native elements
- integration test react native forms

## When to choose
- you are building React Native apps and want user-centric component tests
- you want tests that avoid implementation details and remain stable during refactors
- you use Jest or another test runner and need React Native runtime simulation
- you want realistic user event simulation (type, press) in tests

## When to avoid
- you are testing plain React web apps (use React Testing Library instead)
- you need true end-to-end tests on real devices or emulators (use Detox or Maestro)
- your project does not use React or React Native

## Facets
- artifact type: library
- maturity: active
- function: testing, e2e-testing, mocking
- domain: testing, mobile-development, frontend, developer-tools
- platform: cross-platform
- tags: react-native, jest, test-renderer, user-event, component-testing, unit-testing, nodejs, mobile

## Member repositories
- callstack/react-native-testing-library (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:03.503513+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-29T18:38:29.763347+00:00, confidence not recorded.
  - readme: https://github.com/callstack/react-native-testing-library (fetched 2026-08-28T04:08:03.503513+00:00, sha 38f75679cf32)
  - homepage: https://oss.callstack.com/react-native-testing-library/ (fetched 2026-08-29T09:32:31.402994+00:00, sha d21a21bcaa57)
  - site_page: https://oss.callstack.com/react-native-testing-library/docs/start/intro (fetched 2026-08-29T09:32:31.405511+00:00, sha 36900d90f526)
  - site_page: https://oss.callstack.com/react-native-testing-library/docs/start/quick-start (fetched 2026-08-29T09:32:31.407233+00:00, sha ff8f06c69473)
  - site_page: https://oss.callstack.com/react-native-testing-library/docs/api (fetched 2026-08-29T09:32:31.408788+00:00, sha d225e4beb353)
- Data as of 2026-08-30T08:39:29.467469+00:00.
