Fullstory's React Native plugin exposes access to the Fullstory Native Mobile SDK from within a React Native app. This plug-in is intended to be used in conjunction with Fullstory for Mobile Apps.
| React Native version | @fullstory/react-native version |
|---|---|
>=0.83.0 |
>=1.10.0 |
<=0.82.0 |
~1.9.0 |
npm i @fullstory/react-native --save
yarn add @fullstory/react-native
expo install @fullstory/react-native
CocoaPods trunk is read-only from December 2, 2026, and no longer accepts new Fullstory versions. Add the Fullstory pod to ios/Podfile with a URL instead:
pod 'FullStory', :http => 'https://ios-releases.fullstory.com/fullstory-X.Y.Z-xcframework.tar.gz'Then run pod update FullStory from the ios directory. The pod name is case-sensitive. To upgrade later, change the version in the URL and run pod update FullStory again.
pod install fails if the Podfile has no FullStory line, or one without a URL, since that pod would come from trunk. To build anyway, set FS_ALLOW_TRUNK=1.
Expo apps don't need this step. The config plugin adds the line for you.
See the iOS setup guide for the build phase and other steps.
@fullstory/babel-plugin-react-native is automatically included as a dependency to the Fullstory React Native plugin. Please refer to the babel plugin's README.md for information on how to configure it.
@fullstory/babel-plugin-annotate-react is automatically included as a dependency to the Fullstory React Native plugin. Please refer to the babel plugin's README.md for information on how to configure it for React Native.
In order to use the Fullstory Native Mobile SDK from within a React Native app, importing the React Native plugin is all that is required.
Here's an example of importing the SDK in a React Native app.
import Fullstory from '@fullstory/react-native';This package cannot be used in the "Expo Go" app because it requires custom native code.
Add the config plugin to the plugins array of your app.json or app.config.json
{
"expo": {
"plugins": [
[
"@fullstory/react-native",
{
"version": "1.28.0",
"org": "ABC",
"additionalConfigs": {
"ios": {
"PreviewMode": true
},
"android": {
"previewModeEnabled": false
}
}
}
]
]
}
}Plugins allow for extra customization by passing in an object with properties. If no extra properties are added, defaults will be used. Certain properties are required.
| Property | Platform | Required | Description |
|---|---|---|---|
| version | Android & iOS | ✅ | Fullstory for Mobile Apps plugin version. |
| org | Android & iOS | ✅ | Your assigned organization ID. |
| host | Android & iOS | Optional. Defaults to: fullstory.com |
The server url your sessions are sent to. |
| recordOnStart | Android & iOS | Optional. Defaults to: true |
Setting RecordOnStart to false will prevent data capture until you explicitly invoke FS.restart() API. |
| additionalConfigs | Android & iOS | Optional. Defaults to: nil |
Pass additional configurations to Android or iOS. |
| enabledVariants | Android | Optional. Defaults to: release |
Specifies which variants to apply Fullstory instrumentation. |
| logLevel | Android | Optional. Defaults to: info |
Captures any log statements at or above the specified level. |
| logcatLevel | Android | Optional. Defaults to: off |
Captures any Logcat messages at or above the specified level. |
| includeAssets | iOS | Optional. Defaults to: nil |
Specify webview file types to upload for playback. This is strongly recommended if you intend to capture WebViews. |
| infoPlistPath | iOS | Optional. Defaults to: nil |
Specify the location of your info.plist file in case we cannot find it automatically in the app bundle. Suggested value: "${SRCROOT}/${INFOPLIST_FILE}" |