Installation#

Prerequisites#

To build and test the Data Wallet you will need the following installed:

Getting Started#

In this tutorial, we will walk you through configuring and setting up your project to test on a physical device using Expo Go.

What You Will Achieve#

By working through this guide, you will:

  1. Install the project dependencies.

  2. Establish a correctly configured development environment.

  3. Successfully install your project into the Expo Go app on your device.

  4. Celebrate your accomplishment with a well-deserved coffee break.

Install Dependencies#

First, clone the project and install dependencies using NPM.

$ git clone https://github.com/inrupt/inrupt-data-wallet.git
$ cd inrupt-data-wallet
$ npm ci

Configuration and Setup#

Configure Build Environment#

Copy the contents of .env.sample file into .env. Only two of these variables are relevant to this tutorial as they define the backend Wallet Services the Wallet will connect to:

EXPO_PUBLIC_LOGIN_URL=https://datawallet.inrupt.com/oauth2/authorization/wallet-app
EXPO_PUBLIC_WALLET_API=https://datawallet.inrupt.com

Running in Expo#

To start Expo, run the following command:

$ npx expo start

At this point you could open emulators for specific platforms but for the purposes of this tutorial, use the platform-independent Expo Go environment.

After Expo has started, make sure it targets the Expo Go environment (as opposed to “development build”). This will display a QR code which you will need to scan with your device.

The Wallet application will then build and install into your device for you to test.

Taking this further#

If you are ready to start making changes to the Wallet you will need to use more advanced configuration and tooling. This is described in detail in the Wallet repository.