react-native-gesture-handler

3.4.0 · 16 Oct 2026MIT5.9M / weekRepository Homepage npm Atom feed

Latest releases

3.x · latest line
3.4.0
16 Oct 2026
- [iOS] add SPM build support
- [Android] Add pressOutAfterAnimation prop to Touchable
- [iOS] Implement pressOutAfterAnimation on Touchable
Important changes
[iOS] add SPM build support
[Android] Add pressOutAfterAnimation prop to Touchable
[iOS] Implement pressOutAfterAnimation on Touchable
Rename pressOutAfterAnimation to immediatePressOut
[Android] Dispatch onPressIn when the native press starts
Improvements
[Android] Align the alpha traversal gate with iOS
Scan mount relations directly instead of rebuilding tag arrays
[Web] Align Tap maxDelay default with native (200 ms)
[Web] Make ScrollView an intercepting detectors
Bug fixes
[Android] Cancel detector gestures when a native view above them takes over the touch
[Android] Fix NPE when a touch cancel callback finishes the handler mid-transition
Make the detector frame cover transformed children
[Android] Allow GestureStateManager.activate from the first onTouchesDown
[iOS] Allow GestureStateManager.activate from the first onTouchesDown
[Web] Allow GestureStateManager.activate from the first onTouchesDown
[Web] Introduce key pointer in KeyboardEventManager
[iOS] Fix manualActivation being ignored after a config update mid-gesture
[iOS] Skip hidden and transparent buttons in hit testing
[Web] Keep detector-owned DOM props across a full config replace
Follow the sign of a SharedValue pan offset on every update
[Web] Detect composed gesture changes in the detector
[Android] Prevent Touchable presses when stopping ScrollView flings
[Android] Don't change state of handlers that haven't received any touches
[Web] Fix view relative coordinates of trackpad pan events
[Web] Map event coordinates through the view's full transform
[General] Link late-mounted gesture objects and skip mount reactions without external relations
[Android] Fix crash when a Text inside a detector gets an inline View
[Android] Reset the native DOWN flag for unmanaged buttons
android: respect pointer events on gesture root views
Expose animatable ref from legacy GestureDetector Wrap
[Android] Clear the pending HOVER_EXIT finish when the hover handler is reset
[Android] Stop nested scroll when the root starts intercepting
Re-send SharedValue config values from the UI thread after binding
[Android] Cancel gestures on native ACTION_CANCEL
[iOS] Keep NativeViewGestureHandler flags across a partial config update
[Android] Check the overflow ancestor pass against the detector child's bounds
Miscellaneous
Bump to React Native 0.88
Expose the module id through a sync TurboModule method instead of a JSI global
Bump proxy-addr from 2.0.7 to 2.0.8 in /packages/docs-gesture-handler
Bump joi from 17.13.7 to 17.13.8 in /packages/docs-gesture-handler
Bump fast-uri from 3.1.7 to 3.1.8 in /packages/docs-gesture-handler
[GitHub] Remove Architecture from the issue template
[E2E] Update flows to await console to hide
[Android] Register all component descriptors in react-native.config.js
[General] Hide non-serializable gesture fields from enumeration
[Web] Register the wheel listener as passive and only for Pan
Allow opt-out from pressOutAfterAnimation in Pressable
Report a VirtualGestureDetector child that swallows the ref
Keep the pointerEvents ts-expect-error in emitted spec declarations
Stop react-native-pager-view from entering the web bundle of the example app
3.3.0
11 Sep 2026
- removed
  Remove REACT_NATIVE_MINOR_VERSION build flag
- removed
  [iOS] Remove a stale TODO in State.ts and the unused constants export
- Keep ReanimatedSwipeable native handlers stable when event callbacks change
Bug fixes
Keep ReanimatedSwipeable native handlers stable when event callbacks change
Forward press handlers as testOnly_* in PressableWithTouchable
Pass reanimatedEventHandler only when the Reanimated detector is used
[Android] Fix buttons firing press events when a scroll takes over the touch
[Android] Fix native handlers attaching to a nested button instead of the detector's child
Fix ReanimatedDrawerLayout animation speed after rerender
Fix dead presses in "never" mode when the keyboard belongs to a native field
Don't pass dependencies to Reanimated hooks on native
[Web] Activate ScrollView's native gesture on real scroll instead of pointer distance
[iOS] Detach handlers when the detector view is recycled
Forward borderless and foreground from android_ripple
[Android] Don't let an awaiting parent handler cancel the child it is waiting for
[Web] Reset NativeViewGestureHandler config on a full config replace
[Web] Restore enabled on a full config replace
[Web] Refresh the DOM after a full config replace
Default shouldCancelWhenOutside to true in useTapGesture
Reset numberOfPointers in LongPressGestureHandler
Reset enableTrackpadTwoFingerGesture in web PanGestureHandler
[iOS] Keep button hit testing within its own subtree
[iOS] Cancel an in-progress press when the button gets disabled
[Android] Release the press when the button gets disabled
[Web] Drop a handler from the orchestrator when it gets disabled mid-gesture
[Web] Drop handlers that never began from the orchestrator
stop circular GestureStateManagerType import on web
[iOS] Preserve disabled button targets under box-none parents
Reset accumulated wheel delta in web WheelEventManager
[Android] Stop nested scroll when a native handler's gesture ends
Miscellaneous
[Android] Remove old Reanimated check
[Android] Initialize the Handler fields eagerly
Use stable Reanimated and Worklets
Fix Errors.test.tsx failing with Reanimated 4.6.0
[Web] Fix delayTimeout type FlingGestureHandler
Escape the JSON-LD against early script termination
Remove stale TODOs
removed
Remove REACT_NATIVE_MINOR_VERSION build flag
Add issue triage comments workflow
Remove stale todo
Flatten same-type nested compositions in useComposedGesture
removed
[iOS] Remove a stale TODO in State.ts and the unused constants export
Remove the @ts-ignore TODO from the event pipeline in jestUtils
Resolve DrawerLayoutAndroid lazily to avoid RN deprecation warning on import
Update Pressable props
Fix v3 CI path filter case and remove stale files entry
[Example] Keep "Basic" in example names, add test ids
Bump joi from 17.13.4 to 17.13.7 in /packages/docs-gesture-handler
Bump svgo from 3.3.4 to 3.3.5 in /packages/docs-gesture-handler
Bump colord from 2.9.3 to 2.10.0 in /packages/docs-gesture-handler
Bump nanoid from 3.3.16 to 3.3.18 in /packages/docs-gesture-handler
Bump fast-uri from 3.1.5 to 3.1.7 in /packages/docs-gesture-handler
3.2.1
14 Aug 2026
- Forward press handlers as testOnly_* in PressableWithTouchable
- Update Pressable props
3.2.0
13 Aug 2026
- Adopt AGP v9
- Implement Pressable based on Touchable
- [Android] Add hover callbacks to Touchable
Important changes
Adopt AGP v9
Implement Pressable based on Touchable
[Android] Add hover callbacks to Touchable
[iOS] Add hover callbacks to Touchable
[Web] Add hover callbacks to Touchable
[Web] Refactor Touchable not to rely on GestureDetector
[iOS] Refactor Touchable not to rely on GestureDetector
[Android] Refactor Touchable not to rely on GestureDetector
Fix fatal crash Cannot read property 'translationX' of undefined when a touch event is serialized without allTouches
Improvements
[Android] Skip the underlay drawable when it can never be visible
[Android] Apply the button's managed handler config once per prop transaction
[Android] Configure the button's handler directly instead of through a ReadableMap
Bug fixes
[Android] Guard update events to only be dispatched in ACTIVE state
Pass empty callbacks to UI when runOnJS is true
[Web] Fix incorrectly calculated timeDelta
[Web] Fix incorrect Tap offset
Fix minVelocity props behavior
[Android] Fix minDistance being reset by partial config updates
Move Interceptor on ScrollView, not its content
[iOS] Re-sync layer opacity and transform from retained props when recycling buttons
[Android] Properly handle requestDisallowInterceptTouchEvent for v3
Fix Touchable not respecting keyboardShouldPersistTaps="handled"
[macOS] Fix touch events never being delivered
crash when mount listener fires after GestureDetector unmount
[macOS] Fix Pan activation criteria being ignored
[macOS] Fix manualActivation never blocking gesture activation
[iOS] Fix touch events never being delivered to VirtualDetector handlers
[iOS] Fix gestures attached via VirtualGestureDetector never recognizing continuous gestures
[macOS] Fix Fling not sending touch events and begin/end states consistently
[Android] Fix handlers cancelled while awaiting leaking in the orchestrator
[iOS] Fix gesture callback guarantees when view is detached mid-gesture
[General] Default GestureDetector moduleId to -1
Clear pending timers on unmount in StatefulPressable
Miscellaneous
Update types to respect Strict TS API
Export PressableEvent type
Update AGENTS.md
Don't dispatch orphaned touch events
Get uiRuntime directly from react-native-worklets
[iOS] Check if enableTrackpadTwoFingerGesture is nil before applying
[General] Pass null hitSlop instead of coercing it to zero
Add Imperative Gesture Handler Testing API
[Android] Fix basic-example hermesc path
Extract CALLBACK_TYPE to shared module
Don't evaluate __DEV__ or Reanimated at module scope
Replace React Native type imports in EventTypes/eventUtils with structural equivalents
De-couple the web handlers from React Native
Use globalThis instead of bare global in utils
Extract the RN-free half of ScrollView interop from ScrollViewResponderInterceptor
Extract HoverEffect to a standalone module
Lift ButtonEvent out of the codegen spec into shared types
Stub the Windows module's Gestures map
[General] Align pointerType across native and JS
[Apple] Remove trailing semicolons from RNGHGestureRecognizerState* macros
[General] Fix stale deprecation messages pointing to Clickable
[macOS] Downgrade react-native-worklets
Move hitSlop normalization to JS
Derive Pressable pressed state from testOnly_pressed
[Android] Resolve the button event dispatcher by react tag
Bump fast-uri from 3.1.2 to 3.1.4 in /packages/docs-gesture-handler
Bump webpack-dev-server from 5.2.5 to 5.2.6 in /packages/docs-gesture-handler
Bump body-parser from 1.20.4 to 1.20.6 in /packages/docs-gesture-handler
Bump shell-quote from 1.8.4 to 1.10.0 in /packages/docs-gesture-handler
Bump svgo from 3.3.3 to 3.3.4 in /packages/docs-gesture-handler
Bump to React Native 0.87
Bump json from 2.11.1 to 2.19.9 in /apps/macos-example
Bump json from 2.12.2 to 2.19.9 in /apps/basic-example
Bump websocket-driver from 0.7.4 to 0.7.5 in /packages/docs-gesture-handler
3.1.0
17 Jul 2026

Notes older than 90 days are read on the Releases tab.

Dependency tracking · free for 3 projects

Know when your own dependencies move

react-native-gesture-handler shipped a new major in the last 12 months, among 18 releases. Inlinr shows which of your projects are behind, and what the upgrade breaks.

Advisories reach you
An email when a critical or high advisory affects a project, before the next install.
Upgrades checked first
Peer ranges, Node, ESM-only and types changes read before you bump.
Only what matters
Majors and breaking notes stay; patches and sibling bumps fold into one line.

How dependency tracking works

Registry facts last checked 21 Oct 2026. Releases and advisories last read 21 Oct 2026.

Latest releases

3.4.0

3.3.0

3.2.1

3.2.0

3.1.0

Know when your own dependencies move