Web Sample App

Complete reference implementation demonstrating Verisoul integration in a React application

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 is a demonstration project built with create-react-app 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)

​
Installation Steps

​
1. Clone the Repository

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:

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:

npm install

​
4. Run the Application

Start the development server:

npm start

The application will be available at 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.