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.