> ## 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 Next.js

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

[Demo](https://superflow-next.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 Next.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 `page.tsx` file

Import the Superflow NPM package with:

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

## 6) Initialize Superflow within `page.tsx`

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.

Be sure to add `"use client"` at the top of your `page.tsx` file to enable client side data-fetching.

```js theme={null}
"use client";

import Image from 'next/image'
import { useEffect } from 'react'
import { initSuperflow } from '@usesuperflow/client'

export default function Home() {

useEffect(()=>{
  //initialize Superflow
  initSuperflow('YOUR_API_KEY', {
    projectId: 'YOUR_PROJECT_ID'
  });

})
return (
  <main className="flex min-h-screen flex-col items-center justify-between p-24">
    <div className="z-10 max-w-5xl w-full items-center justify-between font-mono text-sm lg:flex">
      <p className="text-xl fixed left-0 top-0 flex w-full justify-center border-b border-gray-300 bg-gradient-to-b from-zinc-200 pb-6 pt-8 backdrop-blur-2xl dark:border-neutral-800 dark:bg-zinc-800/30 dark:from-inherit lg:static lg:w-auto  lg:rounded-xl lg:border lg:bg-gray-200 lg:p-4 lg:dark:bg-zinc-800/30">
        Highlight this text to test out Superflow
      </p>
    </div>
  </main>
)
}
```

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

Deploy your Next 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 Next 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 Next site

Now that you have verified that Superflow has been installed on your Next 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>
