Skip to main content

React SDK Installation

Npm package version GitHub


This SDK is compatible with React versions 16.8.0 and above.


For React 17.x, there is an underlying issue for how the React Runtime is resolved.

The interim fix, is to add an alias resolution to your build configuration for 'react/jsx-runtime': require.resolve('react/jsx-runtime').

For more information, please review these Github Issues React Issue, Create React App Issue & related PR React Runtime PR.

For additional help, please contact DevCycle support at [email protected].


To install the SDK, run the following command:


    npm install --save @devcycle/react-client-sdk


  yarn add @devcycle/react-client-sdk

Using With Create-React-App

Due to a known issue with create-react-app and cjs, the following steps are required to ensure compatibility with the SDK.

1. Install react-app-rewired

yarn add react-app-rewired --dev


npm install react-app-rewired --save-dev

2. Create a file at the root of your project called config-overrides.js

// config-overrides.js
module.exports = {
webpack: function (config, env) {
config.module.rules = => {
if (rule.oneOf instanceof Array) {
rule.oneOf[rule.oneOf.length - 1].exclude = [
return rule
return config

3. Update the scripts section of your package.json to use react-app-rewired

/* package.json */

"scripts": {
- "start": "react-scripts start",
+ "start": "react-app-rewired start",
- "build": "react-scripts build",
+ "build": "react-app-rewired build",
- "test": "react-scripts test",
+ "test": "react-app-rewired test",
"eject": "react-scripts eject"