UHN-Mobile-App

University Health Network React Native Mobile Application

Some libraries used in this app:

• Notification and Location Services via expo
• Routing via react-native-router-flux
• Token Authentication via jwt-decode
• Maps via react-native-webview-leaflet
• Data storage and management via react-redux and redux-thunk

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

• Node.js v13 (npm v6) (Download here
• Expo SDK (Run npm install -g expo-cli)
• A running copy of UHN-Backend-Server and Redis Server
  • Redis can be downloaded here or use Homebrew.

Installing

1. Clone the repository: git clone
2. Install the packages: cd UHN-Mobile-App and npm install
3. Create a .env file and set SERVER_ROOT to http://localhost:3000

Running

Start the native app by doing

expo start or npm start

This should open a browser tab with the URL: "http://localhost:19002". The port 19002 may differ if you are running multiple Expo instances, but in general 1900x. If a browser tab isn't opened, simply look through the logs on Expo CLI to find the address.

If you have a physical device, download the "Expo" mobile app from the App Store or Google Play Store. Open up the app and scan the QR code shown either on Expo CLI or the webpage at port 1900x. This should start to build the app on your physical device.

You can launch the app on an Android Virtual Device by running npm run android, or on the iOS Simulator by running npm run ios (macOS only).

Environmental Files

SERVER_ROOT should contain the location where the backend server is running

By default, UHN-Backend-Server will be running on http://localhost:3000

In certain cases, "localhost" is not going to work. You can try to use the Wi-Fi adapter IP address (ipconfig on Windows, ifconfig on macOS)

Changing Environmental Files

When changing environmental files, reset the app using the following method:

1. expo start -c (resets the expo cache)
2. Restart the Expo Bundler (r on the Expo CLI)
3. CTRL^ + C to reset the app

Run the app again using expo start

Components

The app uses components and typography provided by default by ReactNative and from NativeBase

The NativeBase components are located in src/native-base-theme and our custom-made components in src/components

Deployment

None yet

Built With

• React Native - Client and Native Framework
• Expo - Build and Deployment