## Setup

### `.env`

Copy shadow file to `.env`

    cp .env.test.shadow .env

### Install Dependencies

It is assumed you have installed the following:

  * [Node](https://nodejs.org/en/download/)
  * [`yarn`](https://yarnpkg.com/en/)
  * [XCode](https://itunes.apple.com/us/app/xcode/id497799835?mt=12)

Install `watchman`:

    brew install watchman

Install `react-native-cli`:

    yarn add global react-native-cli

Install project dependencies:

    yarn install

### Run the app in the iOS Simulator

Use the `start` target:

    yarn start

Once running, you can hit `i` to launch the iOS Simulator.

**NOTE**: If you get the following error once the app is running: `undefined is not an object 'locale.replace'` please re-set your iOS region settings (US by default). Then relaunch the Expo app and all should be good now.

### Run the app in the Android Emulator

Download and install [Android Studio](https://developer.android.com/studio/).

From the Tools menu select AVD Manager, and use the Create Virtual Device wizard to create an emulator. Once you have
created an emulator, run it with the play button.

**NOTE**: If the emulator does not launch, check the Android Studio logs. If you see an error message about
`qemu-system-x86_64`, the emulator launch may have been blocked by Cylance. Check the CylanceUI exploits tab to see
if it has been blocked explicitly. You will need to communicate with systems to allow this process to run. You may need
to provide the `qemu` version. To obtain this, run the following:

    export DYLD_LIBRARY_PATH="/Users/<user>/Library/Android/sdk/emulator/lib64/qt/lib:$DYLD_LIBRARY_PATH"
    ~/Library/Android/sdk/emulator/qemu/darwin-x86_64/qemu-system-x86_64 -version

Use the `start` target:

    yarn start

Once running, you can hit `a` to launch Expo within the currently running Android emulator.