Integrating Luciq with Expo

Overview

Luciq supports modern Expo development. The recommended way to install Luciq is by using our Expo Plugin, which automatically handles native project configuration and automates the sourcemap uploading process for your standard builds.

📘

Note

The Luciq SDK is not supported in the Expo Go app. You will need to create a development build or use a simulator/physical device.

Recommended Setup: Using the Expo Plugin

This is the simplest and most robust way to integrate Luciq into an Expo project.

Step 1: Install the SDK

In your project directory, run the following command to install the Luciq SDK:

npm install luciq-reactnative

Or, if you prefer using Yarn:

yarn add luciq-reactnative

Step 2: Configure the Expo Plugin

Add the luciq-reactnative plugin to the plugins array in your app.json file.

{
  "expo": {
    "plugins": [
      [
        "luciq-reactnative",
        {
          "addScreenRecordingBugReportingPermission": true //check note below
        }
      ]
    ]
  }
}

The addScreenRecordingBugReportingPermission is an optional helper that automatically adds the required microphone and photo library permissions on iOS and the foreground service permission on Android for the screen recording feature.

Step 3: Rebuild Your App

After adding the plugin, you will need to rebuild your app's native directories for the changes to take effect. Run the following command:

npx expo prebuild

This command will modify your ios and android directories to include the necessary Luciq configurations.

Automatic Sourcemap Uploads

A key benefit of using the Expo Plugin is that it automatically handles sourcemap uploads for all your standard Expo builds (eas build). By adding the plugin to your app.json, it will detect your builds and upload the correct sourcemaps to Luciq with no additional configuration required.

📘

Note

This automatic process applies to standard builds only. For Expo Updates (OTA), you must manually upload sourcemaps using our CLI. See our Over-the-Air (OTA) Updates Guide for more details.

Using Luciq

To start using Luciq, import and initialize the SDK in your app’s main file (e.g. App.js).

import Luciq, { InvocationEvent } from 'luciq-reactnative';

Luciq.init({
  token: 'APP_TOKEN',
  invocationEvents: [InvocationEvent.shake],
});

You can find your app token by selecting SDK Integration in the Settings menu from your Luciq dashboard.

Legacy: Using a Custom Development Client

For older managed workflows that do not use the Expo plugin system, you will need to use Expo’s custom development client.

1. Run npx expo install expo-dev-client.
2. Modify your package.json scripts to use the --dev-client flag for the start command.
   JSON

   "scripts": {
     "start": "expo start --dev-client",
     "android": "expo run:android",
     "ios": "expo run:ios"
   }
   

3. Proceed with the Luciq SDK installation and initialization as described above.