React Native





Unreal Engine



SDK Installation
AndroidiOSCocosCordovaFlutterIonicReact NativeUnityUnreal Engine 4Xamarin
SDK Conceptual
SDK API reference
SDK Cookbooks
SDK Integrations
REST API (beta)

React Native SDK Installation

Managed Expo apps can't be supported due to the explicit technical restrictions imposed by Expo. For details, see Expo Documentation, the FAQ "How do I add custom native code to my Expo project?". Smartlook functionality must be implemented in the native code.

  1. Install the Smartlook RN bridge
npm install smartlook-react-native-wrapper --save
  1. Add dependency on native Smartlook SDK


  • Open android/build.gradle
  • Update gradle version to classpath '' in case you are using older React native version
  • Add our maven repository:
allprojects {
repositories {
maven {
url ""

Also edit so you are using: This step is not needed in newer React native versions.


Smartlook native library is installed as a Cocoapods dependency.

There are no manual steps required, just make sure your Cocoapod dependecies are up-to-date after Smartlook RN installation dependecy.

  1. Import Smartlook, setup it and start recording
var Smartlook = require('smartlook-react-native-wrapper');

To setup Smartlook, the unique project API key is needed. It can be found in the mobile project settings in Smartlook Dashboard.

  1. Smartlook now starts recording the app. The recordings will appear in the Smartlook player shortly.

SDK will upload sessions only on WiFi. When uploading on mobile connections is requested, it must be enabled in the project settings in the dashboard. More details about the recording process can be found in the Conceptual documentation.

Supported versions

React Native version 0.60+ on iOS 10+ and Android Jelly Bean (API 18).

Further Steps

All Smartlook SDK methods are documented in the Smartlook API reference.

Some advanced use-case and troubleshooting case-studies are described in the Cookbooks section of this documentation.

Issues and bugs can be reported in the issue tracker.

Concepts undelying the Smartlook functionality are descibed in the Conceptual documentation: