Dev guideAPI Reference
Dev guideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Install the React SDK

Steps to install the Optimizely Feature Experimentation React SDK into your application.

The React SDK can be used in both ReactJS and React Native environments and is distributed through npm. The React SDK supports datafile caching and offline events persistence for React applications. Add it to your package with NPM:

npm install --save @optimizely/react-sdk

or with Yarn:

yarn add @optimizely/react-sdk

The full source code is at


The React SDK requires an ES5-compatible environment, as well as Promise. To run in environments that do not support promise, you can use promise-polyfill.

Peer dependencies

To use the features such as datafile caching and offline events persistence, you need to install the following peer dependencies in your React Native application.

yarn add @react-native-async-storage/async-storage @react-native-community/netinfo
npm install --save @react-native-async-storage/async-storage @react-native-community/netinfo

@react-native-async-storage/async-storage is required to:

  • enable datafile caching by storing the datafile on the user's device.
  • enable event offline persistence by temporarily storing events on user's device when offline.

@react-native-community/netinfo is required to detect when internet connectivity is restored, so that events triggered during the offline mode can be retried.