Quickstart

Initial Setup

Download the repo as per general instruction

Follow instructions from the main readme to clone this repo and yarn package manager

Ensure all packages are up-to-date

yarn install

Setup required configuration

In order to sync content from google drive, a set of application credentials is required to be placed in the packages/scripts/config folder.

Developer credentials can be requested from the dev team.

Using custom credentials

It is also possible to use your own credentials generated following instructions at: https://developers.google.com/identity/protocols/oauth2/web-server#creatingcred

If creating your own credentials the redirect_uri should be set to http://localhost:3003/oauth2callback and authorized javascript origins to include http://localhost

Connect to Google Drive

All users need to connect to their personal Google Drive account to access files shared in content folders. This only has to be done once to grant permission to read files and file metadata (e.g. dates modified) from the google drive.

To connect to your Google account you must run:

yarn workflow sync_authorize

You will be prompted to sign into your Google account in a browser window and grant the app access. You may see a warning message to connect the unverified app. Use the advanced dropdown to accept.

Working with Content

Sync and Process latest Google Drive data

You can download the data from deployment content folder(s) from Google Drive on demand to view the latest version. Simply run:

yarn workflow sync

You will see a summary of the output showing and details can be found in the referenced log folder.

You will also see any potential issues flagged with warning messages, and two summary tables - one of data that was skipped (ignored) and one of App Data that has been passed for processing.

Viewing changes in the app

Any changes downloaded will also be available to the app when running locally. To run the app with your latest downloaded data simply run

yarn start

Committing changes

For committing changes, see GitHub Management