---
id: example
title: Running Example App
---

import useBaseUrl from '@docusaurus/useBaseUrl';
import GifGallery from '@site/components/GifGallery'

Example app code is located under [`example/`](https://github.com/software-mansion/react-native-gesture-handler/tree/master/example) folder in the repo.
It showcases the majority of the Gesture Handler library features.
The app consist of the list of single screen examples presenting the capabilities of the library.
Each example is located under a separate folder under [`example/`](https://github.com/software-mansion/react-native-gesture-handler/tree/master/example).

<GifGallery>
    <img src={useBaseUrl("gifs/sampleapp.gif")} width="180" height="320" />
</GifGallery>

## Running example app locally

Before you begin you should follow [React Native's setup steps](http://facebook.github.io/react-native/docs/getting-started.html) to make sure you have all the tools necessary to build and run React Native apps installed.
The example app is a regular React Native app, so in case of problems or to learn about available commands you may want to [check react-native cli documentation](https://github.com/react-native-community/cli/blob/master/README.md).

In order to run example app you need to clone the repo first:

```bash
git clone git@github.com:software-mansion/react-native-gesture-handler.git
```

Then go to the library folder:

```bash
cd react-native-gesture-handler/
```

Install dependencies of library with the following command:

```bash
yarn
```

Then go to the `example` folder:

```bash
cd example
```

Install dependencies of example with the following command:

```bash
yarn
```

Run development server:

```bash
yarn start
```

Finally run one of the commands below in order to build, install and launch the app on Android:

```bash
yarn android
```

or on iOS:

```bash
yarn ios
```

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