Installation

Prerequisites

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

• Git,

• Node and NPM,

• Expo Go - install this app on your mobile phone for on-device testing,

• A PodSpaces account.

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/openwallet-foundation-labs/solid-data-wallet
$ cd solid-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:

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.