> ## Documentation Index
> Fetch the complete documentation index at: https://docs.verisoul.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Sample App

<CardGroup cols={1}>
  <Card title="Web Sample App" icon="github" iconType="brands" href="https://github.com/verisoul/react-sample-app.git">
    Complete reference implementation demonstrating Verisoul integration in a React application
  </Card>
</CardGroup>

This guide will help you set up and run the React Sample App, which demonstrates how to integrate Verisoul into a React application.

## About the Sample App

The [Verisoul React Sample App](https://github.com/verisoul/react-sample-app) is a demonstration project built with [create-react-app](https://create-react-app.dev/) that showcases a working Verisoul integration. The app includes:

* A React frontend using Verisoul's script tag
* An Express API server backend

## Prerequisites

Before you begin, you'll need:

* Node.js and npm installed on your system
* Git for cloning the repository
* A Verisoul API Key and Project ID (obtain these by [scheduling a call](https://meetings.hubspot.com/henry-legard))

## Installation Steps

### 1. Clone the Repository

```bash theme={null}
git clone https://github.com/verisoul/react-sample-app.git
cd react-sample-app
```

### 2. Configure Environment Variables

Create a `.env` file from the provided sample and add your Verisoul credentials:

```bash theme={null}
cp .env.sample .env
```

Open the `.env` file in your preferred text editor and fill in the following values:

* `VERISOUL_API_KEY` - Your Verisoul API key
* `VERISOUL_PROJECT_ID` - Your Verisoul project ID

### 3. Install Dependencies

Install all required npm packages:

```bash theme={null}
npm install
```

### 4. Run the Application

Start the development server:

```bash theme={null}
npm start
```

The application will be available at [http://localhost:3000](http://localhost:3000).

## What to Expect

Once running, you'll see a demonstration of how Verisoul's fake user detection works in a React environment. This includes:

* User verification flows
* Integration with Verisoul's JavaScript SDK
* Backend API calls to Verisoul services

## Next Steps

After exploring the sample app, you can use it as a reference for implementing Verisoul in your own React applications.

For more detailed documentation, see the [Verisoul Integration Guide](/integration/overview).