Quick Start - React Native
Get UXCam running in your React Native app in 5 minutes
React Native Quick Start
Get session recording working in your React Native app in under 5 minutes.
Prerequisites
- React Native 0.68+ or Expo SDK 47+
- iOS deployment target 12.0+ / Android minSdkVersion 21+
- A UXCam account with an app key
Note
Using Expo? Managed workflow requires EAS Build. See our Expo installation guide for details.
Step 1: Install the Package
# npm
npm install react-native-ux-cam
# yarn
yarn add react-native-ux-camFor iOS, install pods:
cd ios && pod installStep 2: Initialize UXCam
In your App.js or entry file:
import RNUxcam from 'react-native-ux-cam';
// Enable video recording (required)
RNUxcam.optIntoVideoRecordings();
// Start UXCam
RNUxcam.startWithConfiguration({
userAppKey: 'YOUR_APP_KEY',
enableAutomaticScreenNameTagging: false,
enableImprovedScreenCapture: true,
});TypeScript version
import RNUxcam from 'react-native-ux-cam';
interface UXCamConfig {
userAppKey: string;
enableAutomaticScreenNameTagging?: boolean;
enableImprovedScreenCapture?: boolean;
}
const config: UXCamConfig = {
userAppKey: 'YOUR_APP_KEY',
enableAutomaticScreenNameTagging: false,
enableImprovedScreenCapture: true,
};
RNUxcam.optIntoVideoRecordings();
RNUxcam.startWithConfiguration(config);Step 3: Verify It Works
- Run your app on a device or emulator
- Navigate through a few screens
- Send the app to background
- Check your UXCam Dashboard - your session should appear within 30 seconds
Tip
Check Xcode console (iOS) or Android Studio logcat for UXCam initialization messages.
Next Steps
You're recording sessions! Now customize your integration:
Updated about 12 hours ago
What's Next? ...
