# software-mansion/react-native-gesture-handler

Declarative API exposing platform native touch and gesture system to React Native.

Repository: https://github.com/software-mansion/react-native-gesture-handler
Canonical: https://ross.abutalabs.com/products/react-native-gesture-handler
Homepage: https://docs.swmansion.com/react-native-gesture-handler/
Language: TypeScript
License: MIT
License Family: permissive
Topics: react-native, gesture, javascript
Last push: 2026-08-26T14:13:49+00:00

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

## Adoption (not part of the score)
Stars 6782, forks 1067 (observed 2026-08-28T04:09:48.570644+00:00)

## What it is
React Native Gesture Handler is a library providing a declarative API that exposes platform-native touch and gesture systems to React Native apps. It recognizes and tracks gestures like pan, tap, pinch, rotation, and fling on the UI thread, replacing the JS-based Gesture Responder System for smoother, more deterministic touch interactions.

## Use cases
- handle swipe and drag gestures in a react native app
- implement pinch-to-zoom and rotation gestures
- build smooth 120fps gesture-driven animations with reanimated
- replace react native gesture responder system for better performance
- create custom touchable buttons with native ripple and underlay feedback
- detect double taps and long presses in react native
- resolve gesture conflicts between scrollviews and pan handlers

## When to choose
- you're building a React Native or Expo app that needs native-feeling touch interactions
- the JS responder system causes jank or dropped frames during gestures
- you need multi-touch gestures like pinch, rotation, or multi-finger pan
- you use Reanimated and want gesture-driven animations on the UI thread

## When to avoid
- you're building a plain web or native (non-React Native) app
- your app only needs simple taps handled by standard RN components
- you can't add native module dependencies (e.g., Expo Go without supported versions)

## Facets
- artifact type: library
- maturity: stable
- function: ui-components, animation, mobile-framework
- domain: mobile-development, frontend, cross-platform
- platform: -
- tags: react-native, gestures, touch-handling, native-ui, reanimated, expo, android, ios, typescript, javascript

## Member repositories
- software-mansion/react-native-gesture-handler (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:48.570644+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-29T17:42:22.070710+00:00, confidence not recorded.
  - readme: https://github.com/software-mansion/react-native-gesture-handler (fetched 2026-08-28T04:09:48.570644+00:00, sha 0c1cb8b1349e)
  - homepage: https://docs.swmansion.com/react-native-gesture-handler/ (fetched 2026-08-29T08:38:46.220778+00:00, sha cf4617e5d9d7)
  - site_page: https://docs.swmansion.com/react-native-gesture-handler/docs/fundamentals/getting-started (fetched 2026-08-29T08:38:46.229829+00:00, sha 3d8e6201c1f7)
  - site_page: https://docs.swmansion.com/react-native-gesture-handler/docs/2.x (fetched 2026-08-29T08:38:46.231966+00:00, sha 7d2e60f76999)
  - site_page: https://docs.swmansion.com/react-native-gesture-handler/docs/1.x (fetched 2026-08-29T08:38:46.234805+00:00, sha 428820caf10a)
  - site_page: https://docs.swmansion.com/react-native-gesture-handler/docs/components/touchable (fetched 2026-08-29T08:38:46.237226+00:00, sha d3b75314456e)
  - site_page: https://docs.swmansion.com/react-native-gesture-handler/docs/gestures/use-pan-gesture (fetched 2026-08-29T08:38:46.239583+00:00, sha 290ec897cd06)
  - site_page: https://docs.swmansion.com/react-native-gesture-handler/docs/gestures/use-tap-gesture (fetched 2026-08-29T08:38:46.242012+00:00, sha 5ff8a2fe73fd)
  - site_page: https://docs.swmansion.com/react-native-gesture-handler/docs/gestures/use-rotation-gesture (fetched 2026-08-29T08:38:46.243827+00:00, sha c3e3f6f120cc)
  - site_page: https://docs.swmansion.com/react-native-gesture-handler/docs/gestures/use-fling-gesture (fetched 2026-08-29T08:38:46.245920+00:00, sha 7d037768657b)
- Data as of 2026-08-30T08:39:29.467469+00:00.