> ## Documentation Index
> Fetch the complete documentation index at: https://superflow-claude-superflow-mcp-docs-distribution-b0cixg.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> How to setup Superflow with React.js

[Github Repo](https://github.com/benjvelt/superflow-react)

[Demo](https://superflow-react.vercel.app/?review=true)

## 1) Enter Your Site URL

Enter the site URL you want Superflow to be installed in.

<Frame>
  <img src="https://mintcdn.com/superflow-claude-superflow-mcp-docs-distribution-b0cixg/n4Ttlzoo_zNaKFSB/images/enter-url-final.png?fit=max&auto=format&n=n4Ttlzoo_zNaKFSB&q=85&s=2b8a6571c4a702fbb71a4c339de68729" alt="" width="3736" height="1797" data-path="images/enter-url-final.png" />
</Frame>

## 2) Select NPM from the list of Platforms

Choose NPM from the list of options to install Superflow with React.js.

<Frame>
  <img src="https://mintcdn.com/superflow-claude-superflow-mcp-docs-distribution-b0cixg/rzp_Kf626CpFLNRx/images/select-npm-final.png?fit=max&auto=format&n=rzp_Kf626CpFLNRx&q=85&s=1289f347c6a086b2e1ce23b1b05c88b2" alt="" width="1688" height="952" data-path="images/select-npm-final.png" />
</Frame>

## 3) Copy your unique Superflow Code

Copy the code from the section "Initialize Superflow"

<Frame>
  <img src="https://mintcdn.com/superflow-claude-superflow-mcp-docs-distribution-b0cixg/n4Ttlzoo_zNaKFSB/images/copy-npm-final.png?fit=max&auto=format&n=n4Ttlzoo_zNaKFSB&q=85&s=c0e4f1bd40c9ab44ccc081526c87efc3" alt="" width="644" height="323" data-path="images/copy-npm-final.png" />
</Frame>

## 4) Install the Superflow NPM package

Install the Superflow NPM package with:

```
npm i @usesuperflow/client
```

## 5) Import Superflow into your `App.js` file

Import the Superflow NPM package with:

```
import { initSuperflow } from '@usesuperflow/client'
```

## 6) Initialize Superflow within `App.js`

Import `initSuperflow` from the NPM package and use it to initialize Superflow.

Create a `useEffect` hook and paste in the unique Superflow code you copied earlier.

```js theme={null}
import './App.css';
import logo from './logo.svg';

import { initSuperflow } from '@usesuperflow/client';
import { useEffect } from 'react';


function App() {

  useEffect( () => {
    //initialize Superflow
    initSuperflow('YOUR_API_KEY', {
      projectId: 'YOUR_PROJECT_ID'
    });
  })
  return (
    <div className="App">
      <header className="App-header">
        <img src={logo} className="App-logo" alt="logo" />
          <p>Test out Superflow by highlighting this text.</p>
      </header>
    </div>
  );
}

export default App;


```

## 7) Deploy your React app with your changes.

Deploy your React app with your new changes.

## 8) Verify your Installation

Verify your Superflow installation by clicking the Verify button on the onboarding flow.

<Frame>
  <img src="https://mintcdn.com/superflow-claude-superflow-mcp-docs-distribution-b0cixg/rzp_Kf626CpFLNRx/images/verify-final.png?fit=max&auto=format&n=rzp_Kf626CpFLNRx&q=85&s=faf9307447799a807f53d6737cd3afb4" alt="" width="2998" height="1459" data-path="images/verify-final.png" />
</Frame>

If successful, you should be redirected to your published React site and see the following success message:

<Frame>
  <img src="https://mintcdn.com/superflow-claude-superflow-mcp-docs-distribution-b0cixg/rzp_Kf626CpFLNRx/images/verified-final.png?fit=max&auto=format&n=rzp_Kf626CpFLNRx&q=85&s=75f707e20661194a1fccb6f448a63ab7" alt="" width="1366" height="1206" data-path="images/verified-final.png" />
</Frame>

## 9) Troubleshooting

Having trouble getting your verifying your installation? Here are the common mistakes users encounter when installing Superflow:

* Did you forget to save the Custom Code?
* Did you forget to publish your site?
* Is the browser still loading a cached version?
* Did you add `?review=true` at the end of your url?
* Did you publish your changes on a staging URL while you are trying to access a Prod URL?
* Did you accidentally install multiple Superflow scripts in the Custom Code?

## 10) Navigate to your React site

Now that you have verified that Superflow has been installed on your React site, navigate to your published site and add `?review=true` at the end of the URL to enable Superflow.

`Example: mywebsite.com/?review=true`

## 11) Test out Superflow

You should now see a Superflow toolbar on the bottom right of your screen.

<Frame>
  <img src="https://mintcdn.com/superflow-claude-superflow-mcp-docs-distribution-b0cixg/KtJ8Km680nUWIDhy/images/react-toolbar-final.png?fit=max&auto=format&n=KtJ8Km680nUWIDhy&q=85&s=5f60265c23ce97038f9b89f2aa42686e" alt="" width="1683" height="949" data-path="images/react-toolbar-final.png" />
</Frame>

## 12) Dropping your first comment

Try leaving a comment on your page.

You can leave a comment in several different ways:

* By highlighting any text
* By hovering over any element on the page
* By drawing a box anywhere on the page

You can also leave voice and screen recordings in your comments as well!

<Frame>
  <img src="https://mintcdn.com/superflow-claude-superflow-mcp-docs-distribution-b0cixg/n4Ttlzoo_zNaKFSB/images/demo.gif?s=6f8df184333809e2503864fe76fc8ecb" alt="" width="640" height="360" data-path="images/demo.gif" />
</Frame>
