3.0.0-beta.1

Gesture Handler 3

This is the first beta release for Gesture Handler 3, with significant internal changes tailored towards the new Architecture and a new hook-based API. To get a high-level overview of the changes, you can check out our release blog post, or see the detailed changelog below.

Detailed changelog

• Update how Gesture Handler exposes setGestureState to the Reanimated UI runtime by @j-piasecki in #3207
• Simplify Android event builders by @j-piasecki in #3603
• Remove actions testing build for the old architecture by @j-piasecki in #3604
• Implement base for a native detector component by @j-piasecki in #3599
• NativeDetector <-> Reanimated integration by @m-bert in #3617
• Remove onChange callback references by @m-bert in #3631
• Handle Animated.Event in onUpdate callback by @m-bert in #3630
• Fix onUpdate crash by @m-bert in #3636
• Remove AnimatedEvent action type from NativeDetector by @m-bert in #3646
• Automatically assign dispatchesAnimatedEvents by @m-bert in #3650
• Remove dispatchesAnimatedEvents from the native detector by @j-piasecki in #3652
• Adapt NativeViewGestureHandler to NativeDetector by @m-bert in #3638
• [Web] Native detector component by @akwasniewski in #3637
• [Web] Adapt NativeViewGestureHandler to NativeDetector by @akwasniewski in #3653
• Add override keyword to TypeScript part of codebase by @m-bert in #3667
• Lazy addition of callbacks to useHandler by @m-bert in #3674
• Remove paper support by @latekvo in #3639
• Fix native gesture reattach by @akwasniewski in #3672
• [Web] v3 typing and using handler data by @akwasniewski in #3651
• Fix gesture detach on component drop by @akwasniewski in #3669
• Remove sync-architectures script from commit hook by @m-bert in #3681
• Bind SharedValues in handler config by @m-bert in #3658
• [Web] many children check by @akwasniewski in #3684
• [cherry-pick] Support react-native 0.81 (#3607) by @m-bert in #3688
• Fix ConcurrentModificationException by @m-bert in #3691
• Fix macos newarch flag by @akwasniewski in #3692
• [Web] Config refactor - update logic and drop class field by @akwasniewski in #3673
• Bump Reanimated in expo-example by @m-bert in #3690
• Separate Reanimated from JS by @m-bert in #3682
• Gesture relations by @m-bert in #3693
• [Tests] Tests for relations traversal algorithm by @m-bert in #3701
• Bump libraries versions by @m-bert in #3702
• Properly type gesture config by @m-bert in #3700
• Align web events with native by @akwasniewski in #3707
• Remove remaining any in gesture config type by @m-bert in #3709
• [Web] Separate Reanimated from JS by @akwasniewski in #3683
• Typed gesture hooks by @m-bert in #3706
• Fix relations old api by @akwasniewski in #3715
• [Web] Gesture relations by @akwasniewski in #3713
• Update hook usage in the NativeDetector by @j-piasecki in #3714
• fix relations by @akwasniewski in #3722
• [Web] Remove mouse buttons map by @m-bert in #3728
• [Web] Add name property to handlers by @m-bert in #3729
• Add changeEventCalculator to handlers by @m-bert in #3708
• Add SharedValue type to config. by @m-bert in #3717
• Logic Detector by @akwasniewski in #3689
• Fix composed types by @m-bert in #3744
• Filter config by @m-bert in #3710
• Remove deprecated components by @m-bert in #3734
• Do not use handleGestureEvent for Animated.Event by @m-bert in #3748
• Change logic of worklet detection in config by @m-bert in #3745
• [Web] Disable onPointerMove on hover on gestures other than Hover by @m-bert in #3727
• Split utils into multiple files by @m-bert in #3746
• Add runOnJS to config by @m-bert in #3743
• Add missing types by @akwasniewski in #3731
• Split types by @m-bert in #3750
• Fix hasWorkletEventHandlers by @m-bert in #3758
• [Web] Fix handling of enabled prop by @m-bert in #3726
• Bump node in DFS CI by @m-bert in #3774
• Reattach gestures when the Detector moves back to the window on iOS by @j-piasecki in #3771
• Update props whitelists by @m-bert in #3773
• Clean callbacks when unregistering gesture by @j-piasecki in #3775
• Remove RNGestureHandlerEnabledRootView and gestureHandlerRootHOC by @m-bert in #3780
• Add support for nested Text to LogicDetector by @j-piasecki in #3778
• Remove remaining paper references by @m-bert in #3783
• Remove checks for React 19 by @m-bert in #3785
• One detector to rule them all by @akwasniewski in #3732
• [Android] Remove workaround for touch events allowing to change state too soon by @j-piasecki in #3793
• [General] Fix DiagonalDirections type by @j-piasecki in #3795
• Remove incorrectly passed gestureEvents by @m-bert in #3799
• Rename logic detector to virtual detector by @akwasniewski in #3796
• Virtual detector native gestures by @akwasniewski in #3765
• Throw error when detectors...

2.30.0

🐛 Bug fixes

• [iOS] Fix pan not triggering onFinalize when blocked by @j-piasecki in #3849
• [iOS] Fix onFinalize callbacks on iOS 26 by @m-bert in #3855
• Fixing number of touches becoming 0 issue for pan gestures in apple track pad by @DImuthuUpe in #3865
• [iOS] Fix manual activation crash by @m-bert in #3890
• [Web] Fix press out by @akwasniewski in #3833
• [android] fixed experimental pointers breaking after pan by @akwasniewski in #3801
• [android] fix scroll actions interpreted as touch by @kosmydel in #3850
• ReanimatedDrawerLayout: fix buttons not receiving onPress by @peterpme in #3832
• Fix memory leak in ReanimatedSwipeable on programmatic close by @kulak91 in #3790

🔢 Miscellaneous

• [General] Throw when no gesture is passed to the GestureDetector by @j-piasecki in #3884
• Support react-native 0.83 by @m-bert in #3822
• [General] Change nightly version name by @j-piasecki in #3862
• Add null to GestureRef type by @m-bert in #3821
• chore: fix typos in docs for force touch gesture by @a1isaeed in #3797
• Hide incorrectly exposed ReanimatedSwipeable props. by @m-bert in #3820
• [Web] Fixed Accessing element.ref was removed in React 19 error by @rmarquois in #3804

New Contributors

• @kulak91 made their first contribution in #3790
• @a1isaeed made their first contribution in #3797
• @rmarquois made their first contribution in #3804
• @kosmydel made their first contribution in #3850
• @DImuthuUpe made their first contribution in #3865

Full Changelog: v2.29.1...v2.30.0

2.29.1

🐛 Bug fixes

• [android] fix ripple effect after #3742

2.29.0

❗ Important changes

• [iOS] Fix gestures not ending properly on iOS 26 by @m-bert in #3740

👍 Improvements

• Bump react-native-builder-bob by @m-bert in #3751
• [Android] build.gradle cleanup by @m-bert in #3741

🐛 Bug fixes

• Fix grabbing delegate in setPressed by @akwasniewski in #3742
• [iOS] Fix gestures on iOS 26 by @m-bert in #3756
• fix: ensure SwipeDirection is imported as a value in ReanimatedSwipeable by @christianbach in #3666
• Fix: exclude libfbjni.so by @Maschga in #3721
• fix: gesture not activating due to outdated handler tag by @hannojg in #3578
• Fix Pressable's onPress being called on cancellation by @latekvo in #3678

🔢 Miscellaneous

• Add workflow for releases by @m-bert in #3760
• Add working directory to publish workflow by @m-bert in #3762
• Fix Fling tsdoc by @m-bert in #3724
• Bump node on CI by @m-bert in #3753
• Rename argument ev to event by @tomekzaw in #3695
• Fix paper CI by @m-bert in #3677
• Fix "build MacOS" CI taking a long time to complete by @latekvo in #3679
• Support react-native 0.82 by @m-bert in #3699
• Update metro.config.js in example apps by @m-bert in #3718
• Downgrade react-native-macos by @m-bert in #3661
• Bump examples to React Native 0.81 by @m-bert in #3676

New Contributors

• @christianbach made their first contribution in #3666
• @Maschga made their first contribution in #3721
• @hannojg made their first contribution in #3578

Full Changelog: 2.28.0...2.29.0

2.28.0

❗ Important changes

• Support react-native 0.81 by @m-bert in #3607
• Deprecate gestureHandlerRootHOC by @m-bert in #3632

👍 Improvements

• Update link in the error message by @j-piasecki in #3625

🐛 Bug fixes

• [Web] fixed texinput submition when inside pressable by @akwasniewski in #3623
• [Web] Fix bottom hitslop by @m-bert in #3644
• [Web] fixed repeated listener registration by @akwasniewski in #3626

🔢 Miscellaneous

• [Android] Revert "fix: turn off build IDs for reproducibility (#3602)" by @m-bert in #3660
• docs: update reanimated_swipeable.md by @hqwlkj in #3647
• docs: update swipeable.md by @hqwlkj in #3648
• docs: update reanimated-drawer-layout.mdx by @hqwlkj in #3649
• docs: update touchables.md by @hqwlkj in #3655
• docs: update pressable.mdx by @hqwlkj in #3656
• docs: update drawer-layout.mdx by @hqwlkj in #3657
• Fix link to the example app in the documentation by @j-piasecki in #3629

New Contributors

• @hqwlkj made their first contribution in #3647

Full Changelog: 2.27.2...2.28.0

2.27.2

❗ Important changes

• [Android] Use asReversed instead of reversed by @m-bert in #3598

👍 Improvements

• Cleanup ReanimatedSwipeable by @latekvo in #3579
• fix: turn off build IDs for reproducibility by @Rexogamer in #3602
• Fix Pressable requiring dimensionsAfterResize by @latekvo in #3606
• [docs] Add info about using focal / anchor points by @m-bert in #3614
• [jest] Fixing enabled prop in buttons by @akwasniewski in #3612

🐛 Bug fixes

• [iOS] Fix GestureDetector on Text by @m-bert in #3591
• [Android] Fix onTouches* callbacks being called for all gestures by @m-bert in #3596
• Fix Pressable onPress callback not working by @latekvo in #3597
• Dropping handlers when components are dropped by @akwasniewski in #3619

🔢 Miscellaneous

• Update ReanimatedSwipeable module path by @m-bert in #3605
• Automatically commit generated schema files by @j-piasecki in #3590
• Fix combo example crashing. by @latekvo in #3587
• docs: add Radon IDE banner to TOCItems by @kacperkapusciak in #3592
• Make dev client default when starting expo-example by @m-bert in #3615

New Contributors

• @Rexogamer made their first contribution in #3602
• @akwasniewski made their first contribution in #3612

Full Changelog: 2.27.1...2.27.2

2.27.1

What's Changed

• Fixed /lib missing in the 2.27.0 npm release

Full Changelog: 2.27.0...2.27.1

2.27.0

❗ Important changes

• Complete Pressable refactor. by @latekvo in #3571
• Deprecate ForceTouch gesture by @m-bert in #3550

🐛 Bug fixes

• Copy README.md to package by @m-bert in #3558
• Fix possible web crashes by @billouboq in #3553
• [Web] Make PointerTracker elements nullable by @m-bert in #3565

🔢 Miscellaneous

• [Android] Cleanup CMakeLists by @m-bert in #3563
• Update compatibility table by @m-bert in #3557
• Update version compatibility table in the documentation by @j-piasecki in #3561
• Don't call needs-repro CI on comments by @latekvo in #3570
• [Web] Extract coords assignment into helper functions by @m-bert in #3574
• docs: Fix testimonial profile picture link by @j-piasecki in #3585
• Fix state transition flowchart docs by @latekvo in #3580

New Contributors

• @billouboq made their first contribution in #3553

Full Changelog: 2.26.0...2.27.0

2.26.0

❗ Important changes

• Support react-native 0.80 by @m-bert in #3530

👍 Improvements

• [iOS] Avoid unnecessary string allocations by @m-bert in #3499
• Add relation props to Pressable and ReanimatedSwipeable by @m-bert in #3473
• [Android] Update build tools by @m-bert in #3544

🐛 Bug fixes

• fix: use providers.exec to enable configuration-cache by @lukmccall in #3504
• Don't block onPress if onLongPress is not defined by @m-bert in #3549
• Fix onSwipeableWillClose called on opening of ReanimatedSwipeable by @m-bert in #3478
• Fix buttons getting stuck in scroll views during overscroll by @j-piasecki in #3509

🔢 Miscellaneous

• [Monorepo] Migrate to monorepo by @m-bert in #3482
• Upgrade react-native-builder-bob by @satya164 in #3468
• Update how handler configuration is handled on Android by @j-piasecki in #3484
• Refactor RNGestureHandlerModule on android by @j-piasecki in #3489
• Make base GestureHandler on Android non generic by @j-piasecki in #3491
• Update usage of types from React Native to make them compatible with Strict API by @j-piasecki in #3532
• Update common example not to disable E2E by @j-piasecki in #3531
• [Web] Fix hot reload by @m-bert in #3540
• Update issue template by @j-piasecki in #3508
• Fix incorrect paths by @m-bert in #3548
• Fix kotlin formatting by @j-piasecki in #3535
• Fix needs-more-info action by @m-bert in #3546
• Fix yarn format:apple script by @m-bert in #3500
• Fix sync architectures command failing on the commit hook by @j-piasecki in #3534
• Support react-native 0.79 by @m-bert in #3436
• Change prepare script to postinstall in the root package.json by @j-piasecki in #3483
• Remove eslintIgnore from package.json by @m-bert in #3533
• Bump react-native-reanimated by @m-bert in #3545
• Bump expo to stable 53 by @m-bert in #3527
• Bump image-size from 1.1.1 to 1.2.1 in /FabricExample by @dependabot in #3472
• docs: Bump t-rex to stable with Docusaurus 3.7 by @patrycjakalinska in #3516

New Contributors

• @lukmccall made their first contribution in #3504

Full Changelog: 2.25.0...2.26.0

2.25.0

❗ Important changes

• Add react-native-svg interface by @latekvo in #3242
• Assign new handlerTag each time handler is created by @m-bert in #3453
• [Android] Suppress UIManagerType error by @m-bert in #3466

👍 Improvements

• Set default accessible prop on Pressable by @m-bert in #3463
• Wrap Pressable with forwardRef by @m-bert in #3431

🐛 Bug fixes

• Fix: onPress callbacks are invoked for all nested Pressables by @coado in #3295
• [iOS] Pass accessibility props to button view by @m-bert in #3444
• [iOS] Fix activeOpacity in BorderlessButton by @m-bert in #3433
• Fix: race condition on attachedGestures in updateHandlers by @uyt95 in #3425
• [Android] Handle hover events in RNGestureHandlerRootHelper by @m-bert in #3462
• [Web] Change shouldBeCancelledByOther to respect blocksExternalGesture by @m-bert in #3429

🔢 Miscellaneous

• Update versions in compatibility tables by @m-bert in #3424
• Bump react-native-reanimated by @m-bert in #3430
• Bump actions on CI by @m-bert in #3432
• [macOS] Re-generate locks by @m-bert in #3437
• Migrate to Yarn 4 by @m-bert in #3457
• [docs] Set yarn version by @m-bert in #3461
• [Android] Add missing SVG files by @m-bert in #3465
• Remove ref type from props in Pressable Example by @m-bert in #3446
• Remove unnecessary version checks by @m-bert in #3416
• Delete getReactNativeVersion by @j-piasecki in #3452
• Bump serialize-javascript from 6.0.1 to 6.0.2 in /docs by @dependabot in #3422
• Bump esbuild from 0.20.2 to 0.25.0 in /docs by @dependabot in #3400
• Bump undici from 6.21.0 to 6.21.1 in /example by @dependabot in #3359
• Bump nanoid from 3.3.6 to 3.3.8 in /MacOSExample by @dependabot in #3352
• Bump http-proxy-middleware from 2.0.6 to 2.0.7 in /docs by @dependabot in #3438
• Bump @babel/runtime from 7.19.4 to 7.26.10 in /e2e/web-tests by @dependabot in #3447
• Bump @babel/helpers from 7.24.5 to 7.26.10 in /example by @dependabot in #3442
• Bump @babel/helpers from 7.22.15 to 7.26.10 in /e2e/web-tests by @dependabot in #3448
• Bump @babel/runtime from 7.24.5 to 7.26.10 in /example by @dependabot in #3449
• Bump @babel/helpers from 7.26.9 to 7.26.10 in /MacOSExample by @dependabot in #3455
• Bump @babel/helpers from 7.25.6 to 7.26.10 in /FabricExample by @dependabot in #3456
• Bump @babel/runtime from 7.26.9 to 7.26.10 in /MacOSExample by @dependabot in #3454
• Bump @babel/runtime from 7.21.0 to 7.27.0 in /docs by @dependabot in #3460
• Bump @babel/runtime-corejs3 from 7.20.13 to 7.26.10 in /docs by @dependabot in #3443
• Bump prismjs from 1.29.0 to 1.30.0 in /docs by @dependabot in #3439

New Contributors

• @uyt95 made their first contribution in #3425

Full Changelog: 2.24.0...2.25.0