Rebar and URB Development Workstation Setup

Initial Development Machine Setup

The basic setup for web only work is:

Install Node.js, version 8.1 and higher. Make sure that NPM is at least version 5.0.
Install Git.
Install yarn npm install -g yarn.

For complete development environment setup on MacOS, follow:

MacOS Developer Setup for React, React Native, Node and Cassandra Development.

Initial Project setup on local machine

In order to set up the project locally, perform the following steps:

Action	Notes
`git clone https://github.com/codefoundries/UniversalRelayBoilerplate`	Clone from github.
`yarn`	Install node packages.
`yarn setup-local`	Set up default configuration for running the boilerplate.
`yarn update-default-persister memory`	Optional - if you wish to try it without Cassandra, use this command to switch to an in-memory persister.

In addition to the above, you might want to specify JWT_SECRET by modifying the .env file. This step can be skipped if you do not care about the actual security and simply want to get the project running. In order to use the URB tools, set export URB_HOME="/<your local folder for URB>/urb" in etc/profile.

Running in development mode

In order to develop, three servers need to be started: web server, webpack server, React Native packager. This can be done with one command: yarn dev. Alternatively, if you need to develop only for the web you can use yarn devw which only starts the web and webpack servers.

To open the app:

Navigate to http://localhost:26005, or whatever IP was assigned when running yarn update-ip or after installation.

To run the iOS app in the emulator:

If the IP of your development machine has changed, run yarn update-ip.
Run react-native run-ios.

Configuring Cassandra/Elassandra locally

Install and configure Cassandra (or Elassandra) following the steps in Cassandra Installation on Mac (or Elassandra Installation on Mac).
Alternatively, follow the Cassandra installation instructions in user space in MacOS Developer Setup for React, React Native, Node and Cassandra Development.
Update the name of the database and the database server in /.env, or use the defaults. The defaults are:

CASSANDRA_CONNECTION_POINTS=localhost
CASSANDRA_KEYSPACE=urb

Configure to use Cassandra as default persister: yarn update-default-persister cassandra.
Create the database with yarn setup-database.

Configuring Dynamodb locally with Docker

Install Docker.
Navigate to the docker-compose.yml file cd units/urb-persister-dynamodb.
Then run docker-compose up in a new terminal to start up a local dynamo db (or start it via docker Kitematic).
Configure to use DynamoDB as default persister: yarn update-default-persister dynamodb.

Other databases

Instructions for other databases will be added as support for those is added.