{"id":19914726,"url":"https://github.com/fullstorydev/fullstory-react-native","last_synced_at":"2025-05-03T05:31:48.713Z","repository":{"id":37896605,"uuid":"251419922","full_name":"fullstorydev/fullstory-react-native","owner":"fullstorydev","description":"Official FullStory support for React-Native, for native mobile","archived":false,"fork":false,"pushed_at":"2024-02-22T03:09:15.000Z","size":1740,"stargazers_count":34,"open_issues_count":5,"forks_count":10,"subscribers_count":26,"default_branch":"master","last_synced_at":"2024-03-14T21:05:25.196Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fullstorydev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-03-30T20:24:03.000Z","updated_at":"2024-04-15T16:44:30.544Z","dependencies_parsed_at":"2023-02-13T23:46:16.193Z","dependency_job_id":"e3ac64e2-2007-4c93-b78f-8c3017278809","html_url":"https://github.com/fullstorydev/fullstory-react-native","commit_stats":{"total_commits":35,"total_committers":9,"mean_commits":3.888888888888889,"dds":0.4,"last_synced_commit":"423188f280b57979fa8ef345920bc79de8716bda"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullstorydev%2Ffullstory-react-native","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullstorydev%2Ffullstory-react-native/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullstorydev%2Ffullstory-react-native/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullstorydev%2Ffullstory-react-native/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fullstorydev","download_url":"https://codeload.github.com/fullstorydev/fullstory-react-native/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224160259,"owners_count":17265942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T21:36:53.820Z","updated_at":"2024-11-12T21:36:54.317Z","avatar_url":"https://github.com/fullstorydev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FullStory React Native Plugin\n\n[![CircleCI](https://circleci.com/gh/fullstorydev/fullstory-react-native.svg?style=svg)](https://circleci.com/gh/fullstorydev/fullstory-react-native)\n\nFullStory'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](https://www.fullstory.com/mobile-apps/).\n\n## Quick Links\n\n- [FullStory API](https://developer.fullstory.com)\n- [Getting Started Guide](https://help.fullstory.com/hc/en-us/articles/360052419133)\n- [Email us](mailto:mobile-support@fullstory.com)\n\n## Install the React Native plugin\n\n#### with npm\n\n```\nnpm i @fullstory/react-native --save\n```\n\n#### with yarn\n\n```\nyarn add @fullstory/react-native\n```\n\n#### with expo-cli\n\n```\nexpo install @fullstory/react-native\n```\n\n## Configuring the babel plugin\n\n`@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](https://github.com/fullstorydev/fullstory-babel-plugin-react-native/blob/master/README.md) for information on how to configure it.\n\n`@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](https://github.com/fullstorydev/fullstory-babel-plugin-annotate-react/blob/master/README.md) for information on how to configure it for React Native.\n\n## Importing the React Native plugin\n\nIn order to use the FullStory Native Mobile SDK from within a React Native app, importing the React Native plugin is all that is required.\n\n### Importing Example\n\nHere's an example of importing the SDK in a React Native app.\n\n```JSX\nimport FullStory from '@fullstory/react-native';\n```\n\n## Configuring for Expo\n\n\u003e This package cannot be used in the \"Expo Go\" app because [it requires custom native code](https://docs.expo.io/workflow/customizing/).\n\nAdd the config plugin to the plugins array of your `app.json` or `app.config.json`\n\n```json\n{\n  \"expo\": {\n    \"plugins\": [\n      [\n        \"@fullstory/react-native\",\n        {\n          \"version\": \"1.28.0\",\n          \"org\": \"ABC\",\n          \"additionalConfigs\": {\n            \"ios\": {\n              \"PreviewMode\": true\n            },\n            \"android\": {\n              \"previewModeEnabled\": false\n            }\n          }\n        }\n      ]\n    ]\n  }\n}\n```\n\n### Plugin Props\n\nPlugins 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.**\n\n| Property          | Platform      | Required                               | Description                                                                                                        |\n| ----------------- | ------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |\n| version           | Android \u0026 iOS | ✅                                     | FullStory for Mobile Apps plugin version.                                                                          |\n| org               | Android \u0026 iOS | ✅                                     | Your assigned organization ID.                                                                                     |\n| host              | Android \u0026 iOS | Optional. Defaults to: `fullstory.com` | The server url your sessions are sent to.                                                                          |\n| recordOnStart     | Android \u0026 iOS | Optional. Defaults to: `true`          | Setting RecordOnStart to `false` will prevent data capture until you explicitly invoke `FS.restart()` API.         |\n| additionalConfigs | Android \u0026 iOS | Optional. Defaults to: `nil`           | Pass additional configurations to [Android](https://help.fullstory.com/hc/en-us/articles/360040596093-Getting-Started-with-Android-Data-Capture#01F5E7XFMG19SNYS77NYETKDMQ) or [iOS](https://help.fullstory.com/hc/en-us/articles/360042772333-Getting-Started-with-iOS-Data-Capture#01FX61TBJ8FAD9CWBMY31DWSTH).                                                                  |\n| enabledVariants   | Android       | Optional. Defaults to: `release`       | Specifies which variants to apply FullStory instrumentation.                                                       |\n| logLevel          | Android       | Optional. Defaults to: `info`          | Captures any log statements at or above the specified level.                                                       |\n| logcatLevel       | Android       | Optional. Defaults to: `off`           | Captures any Logcat messages at or above the specified level.                                                      |\n| includeAssets     | iOS           | Optional. Defaults to: `nil`           | Specify webview file types to upload for playback. This is strongly recommended if you intend to capture WebViews. |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffullstorydev%2Ffullstory-react-native","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffullstorydev%2Ffullstory-react-native","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffullstorydev%2Ffullstory-react-native/lists"}