Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

## Description

Android requires using GestureHandlerRootView to intercept events,
without it the gestures don't work and buttons hang in the "in-between"
state of pressed and not pressed.

This PR adds logic responsible for checking if gestures are attached to
views mounted under GestureHandlerRootView. If they aren't, the error
message is shown.


## Test plan

Tested on the Example & FabricExample app.

Git stats


Failed to load latest commit information.
Latest commit message
Commit time
February 16, 2021 13:16
January 13, 2023 09:55
February 16, 2021 13:16
February 1, 2023 11:09
February 7, 2022 11:35
January 13, 2023 09:55

React Native Gesture Handler by Software Mansion

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

React Native Gesture Handler provides native-driven gesture management APIs for building best possible touch-based experiences in React Native.

With this library gestures are no longer controlled by the JS responder system, but instead are recognized and tracked in the UI thread. It makes touch interactions and gesture tracking not only smooth, but also dependable and deterministic.


Check getting started section of our docs for the detailed installation instructions.


To learn how to use react-native-gesture-handler with Fabric architecture, head over to Fabric README. Instructions on how to run Fabric Example within this repo can be found in the FabricExample README.


Check out our dedicated documentation page for info about this library, API reference and more:


If you want to play with the API but don't feel like trying it on a real app, you can run the example project. Clone the repo, go to the example folder and run:

yarn install

If you are running on ios, run pod install in the ios folder

Run yarn start to start the metro bundler

Run yarn android or yarn ios (depending on which platform you want to run the example app on).

You will need to have an Android or iOS device or emulator connected as well as react-native-cli package installed globally.

React Native Support

version react-native version
2.0.0+ 0.63.0+
1.4.0+ 0.60.0+
1.1.0+ 0.57.2+
<1.1.0 0.50.0+

It may be possible to use newer versions of react-native-gesture-handler on React Native with version <= 0.59 by reverse Jetifying. Read more on that here


Gesture handler library is licensed under The MIT License.


This project has been build and is maintained thanks to the support from Shopify, and Software Mansion

shopify expo swm