Lifecycle & Recording

SDK instance

A Smartlook SDK instance is instantiated during the Smartlook.instance getter call and is available during the entire application run.

import Smartlook from 'react-native-smartlook-analytics';

const smartlookInstance = Smartlook.instance;

The Smartlook instance getter is used to access all SDK functions and properties.

Project key

Your unique project key is needed for the SDK to upload and process the recordings. You can find your project key in the mobile project settings on the Smartlook Dashboard.


Starting and stopping recordings

Recordings can be started or stopped at any time. Multiple subsequent start() or stop() calls will be ignored.


When a user closes your app, the user session automatically stops recording. You don't need to call the stop() method when the user stops using your app.


Recording start and project key

User sessions can be recorded even if you haven't set the project key. Recorded data are saved but not sent. Once you set the project key, the data is sent.

Checking if the SDK is recording

To see if the SDK is recording:

await Smartlook.instance.state.isRecording();


Why isn't the SDK recording?

You can see why your SDK is not recording by calling Smartlook.instance.state.getRecordingStatus(). For more information on possible reasons the SDK is not recording and status, see Status.

Opening a new session

You can close the current session and start a new session:


Session URL

The URL of the currently recorded session can be obtained with or without a timestamp:

const sessionURL = await Smartlook.instance.user.getSessionUrl();
const sessionURLWithTimestamp = await Smartlook.instance.user.getSessionUrlWithTimestamp();


Nullability and shareability

URLs are only available when the SDK is able to "communicate" with the Smartlook backend. Otherwise, they are null.

URLs are not publicly sharable and login to the dashboard is mandatory before opening these.

Session Listener

A listener can be registered to listen to the session URL changes.

// A callback function that gets called when the session URL changes. Can be asynchronous.
function sessionUrlChangedCallback(sessionUrl: string) {
  console.log('Emitted session url', sessionUrl);