---
updatedAt: 2026-04-08T10:22:09.000Z
---

# Build a sample app to evaluate the Tealeaf React Native SDK

Before you start integrating the Tealeaf SDK into your React Native app, we recommend installing our sample app with the SDK. The sample app has all the UI components of NativeBase.

# Requirements

* **Acoustic Tealeaf**. To view captured sessions and playback from the sample app, you need an active Tealeaf subscription.
* **Development environment**. To build and run the sample app, you need a properly configured React Native environment with Node.js 16-18, Yarn Classic line (1.x) and CocoaPods.
* **Mobile app compatibility**. You can run the sample app on simulators and real devices. Supported operating systems: **iOS 13** and later, **Android 13.0 (API level 33)** and later.

# Before you begin

During the setup, you will need to **register** the sample app with your Acoustic Tealeaf credentials. You can generate them yourself through the Tealeaf interface.

1. Log in to Acoustic Tealeaf as an administrator.
2. In the menu bar, click on your user profile and select **Admin**.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/07e3924-admin-area-access.png",
        "",
        ""
      ],
      "align": "center",
      "sizing": "300px",
      "border": true
    }
  ]
}
[/block]

3. On the **Admin** page, open the **Applications** tab.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/2e27a38-applications-module.png",
        "",
        ""
      ],
      "align": "center",
      "sizing": "600px",
      "border": true
    }
  ]
}
[/block]

4. If a new app is required, click to add an app and fill out required settings.
5. Click the **SDK** link for your app. Copy access credentials from any tab: **application code** and **post message URL**. Keep them handy for the setup.

# Setup instructions

1. Clone the sample app code from our GitHub repository.

```shell
git clone https://github.com/go-acoustic/ea_react_native_module_tealeaf.git
```

2. In a terminal emulator, navigate to `ea_react_native_module_tealeaf/Example/nativebase-v3-kitchensink`.
3. Run the `yarn` command to install the packages.
4. Navigate to the `ios` project directory and install dependencies.

```shell
cd ios
pod update
```

5. Open the primary configuration file: `ea_react_native_module_tealeaf/Example/nativebase-v3-kitchensink/TealeafConfig.json`. Update 2 keys in it using your Tealeaf credentials: `AppKey` and `PostMessageUrl`.

# Run the app

[block:html]
{
  "html": " \n  <ul class=\"nav nav-pills\">\n    <li class=\"active\"><a data-toggle=\"pill\" href=\"#ios\">iOS</a></li>\n    <li><a data-toggle=\"pill\" href=\"#android\">Android</a></li>\n  </ul>\n\n\n<div class=\"tab-content\">\n  <!------------------------START---------------------------->\n  \n<div id=\"ios\" class=\"tab-pane fade in active\">\n  \n<p>Run the following in your terminal.</p>\n<div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\" role=\"tablist\"><button aria-selected=\"true\" class=\"CodeTabs_active\" role=\"tab\" type=\"button\">Shell</button></div><div class=\"CodeTabs-inner\" role=\"tabpanel\"><pre><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang-shell theme-light\" data-lang=\"shell\" name=\"\" tabindex=\"0\"><div class=\"cm-s-neo\" data-testid=\"SyntaxHighlighter\">yarn <span class=\"cm-builtin\">start</span>\nyarn ios\n</div></code></pre></div></div>\n  \n</div>\n  <!------------------------------END IOS ---------------------->\n  <div id=\"android\" class=\"tab-pane\">\n  <ol>\n    <li>Run an Android emulator.</li>\n    <li>Run the following in your terminal.</li>\n  </ol>\n  <div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\" role=\"tablist\"><button aria-selected=\"true\" class=\"CodeTabs_active\" role=\"tab\" type=\"button\">Shell</button></div><div class=\"CodeTabs-inner\" role=\"tabpanel\"><pre><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang-shell theme-light\" data-lang=\"shell\" name=\"\" tabindex=\"0\"><div class=\"cm-s-neo\" data-testid=\"SyntaxHighlighter\">yarn <span class=\"cm-builtin\">start</span>\nyarn android\n</div></code></pre></div></div>\n\n  </div>\n  <!----------------------------END ANDROID---------------------->\n \n  \n</div>\n<!-----------------------------END-------------------------->\n\n <style>\n    .content-body .header-scroll{\n      font-family: National12, Roboto,sans serif;\n      font-size:24px;\n      color:#13173d;\n      font-weight: 400;\n      line-height: 1.2;\n    }\n   \n    .container {\n      width:100%;\n    }\n    .nav-pills > li.active > a, .nav-pills > li.active > a:hover{\n      color:#fff !important;\n      background-color: #047970;}\n    .nav > li > a{\n      color: #047970 !important;\n      font-family: National2,Roboto,sans serif !important;}\n    .nav > li > a:hover {\n      background-color: #047970;\n      color:#fff !important;}\n    .nav-pills > li > a{\n      border: 1px #047970 solid;}\n    .nav > li > a:focus {\n      background-color: #fff;}\n    .nav-pills > li.active > a, .nav-pills > li.active > a:focus {\n      background-color:#047970!important;}\n    .nav-pills > li + li \n    {\n      margin-top: 0 !important;}\n    </style>"
}
[/block]

# Test session replay

Now you can check how user behavior data is captured.

1. Click around in the sample app.
2. In your Tealeaf account, go to **Optimise** > **Session search**.
3. Find the session and click to play it back.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/f311971-session-search-in-tealeaf.png",
        "",
        "Session search in Tealeaf"
      ],
      "align": "center",
      "sizing": "600px",
      "border": true
    }
  ]
}
[/block]

Notes:

* To learn more about the **Sessions** module, see [Session replay](https://help.goacoustic.com/hc/en-us/articles/360042593634-Session-replay) in our marketing guide.
* User sessions in Tealeaf time out after **30 minutes** of inactivity.