Skip to main content

​
Prerequisite

Node.js with npm: Download Node.js via their website or use this interface:

​
Build the Front End

1

Download the Starter Kit

The demo requires port 3000 to run. Before proceeding, ensure that no other applications or processes are using port 3000. Stop any such processes before running the starter kit to avoid conflicts.
Open a terminal and navigate to the location where you would like to install the starter kit. Then paste the following commands into your terminal.
Shell
git clone https://github.com/prove-identity/prove-prefill-react-starter-kit-v3.git
cd prove-prefill-react-starter-kit-v3
cd frontend
npm install
echo "NODE_ENV=sandbox" > .env
echo "REACT_APP_ENV=sandbox" >> .env
echo "REACT_APP_BASE_API_URL=http://localhost:8080/api" >> .env
npm run dev
Following the execution of these commands, you have the following for your front end:
  • The starter kit downloaded and dependencies installed.
  • A formatted .env file.
2

Run the Front end

Navigate to your front end app at http://localhost:3000/.

​
Build the back end

1

Configure the Back End

Open a second terminal and navigate to the location where you installed the starter kit.
A second terminal is necessary so you don’t cancel the front end app you just started.
Paste the following commands into your terminal.
cd prove-prefill-react-starter-kit-v3
cd backend
npm install
echo "NODE_ENV=sandbox" > .env
echo "PROVE_CLIENT_ID=REPLACE_WITH_YOUR_SANDBOX_CLIENT_ID" >> .env
echo "PROVE_CLIENT_SECRET=REPLACE_WITH_YOUR_SANDBOX_CLIENT_SECRET" >> .env
echo "APPLICATION_DOMAIN=http://127.0.0.1:3000" >> .env
notepad .env
Following the execution of these commands, you have the following for your backend:
  • The back end dependencies installed.
  • A formatted .env file.
2

Acquire Sandbox Credentials from the Developer Portal

To run the back end, you need to authenticate using Sandbox credentials.
  • Login to the Developer Portal.
  • Navigate to Projects and create a new project. When selecting a solution, choose Prove Pre-Fill.
  • Select your project and navigate to the CREDENTIALS tab.
3

Edit the .env File

Switching back to the text editor that opened in a previous step, copy, and paste your Client ID in place of REPLACE_WITH_YOUR_SANDBOX_CLIENT_ID, and your Client Secret in place of REPLACE_WITH_YOUR_SANDBOX_CLIENT_SECRET. Save and close when finished.
4

Run the Back End

Execute npm run dev via the terminal.

​
Try it out

1

Enter the Test User's Challenge Data

Enter the following test user data and select Continue.
Screenshot of Prove Pre-Fill demo screen showing user challenge data entry form
2

Simulate the Instant Link

Wait for a few seconds while the app simulates the Instant Link possession check.
Screenshot of Prove Pre-Fill demo screen showing simulated Instant Link process
3

Confirm Test User Identity Data

Select Confirm after reviewing the prefilled information.
Screenshot of Prove Pre-Fill demo screen showing prefilled user identity data
Success. You have now seen the Prove Pre-Fill solution in action.Review the documentation for this and other use cases to see how Prove integrates into your app to solve your identity verification needs.
⌘I