Graasp App Starter: React Framework

This is a starter repository for a Graasp application. This particular flavor of the starter repository uses the React framework. It is an opinionated starter kit based on the create-react-app package. Other flavors are coming.

Getting Started

Fork this repo.

Request Credentials

Currently, becoming a Graasp Developer and registering Graasp Apps is a manual process. Contact juancarlos.farah@epfl.ch or andre.nogueira@epfl.ch to receive a GRAASP_DEVELOPER_ID. Every time you want to release a new app, you will also have to request a GRAASP_APP_ID. This process is being automated, but it's currently still in the works.

We will also give you AWS credentials, AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY, which you will need to deploy your application to the Graasp ecosystem. These keys are private, so you should not share them with anyone.

Environment Variables

To start developing locally, you should create a .env.local file in your root folder with the following content:

REACT_APP_APPS_DEVELOPER_ID=
REACT_APP_APP_ID=
REACT_APP_GRAASP_DOMAIN=localhost
REACT_APP_HOST=
REACT_APP_VERSION=
REACT_APP_BASE=

Once you are ready to deploy your application to our development server, you will need to create a .env.dev file in your root folder following the patter below. Replace the value between <> with those that you received from our developers. Please make sure you do not commit or share the values between <> with anyone, as they are confidential.

REACT_APP_APPS_DEVELOPER_ID=<REACT_APP_APPS_DEVELOPER_ID>
REACT_APP_APP_ID=<REACT_APP_APP_ID>
REACT_APP_GRAASP_DOMAIN=graasp.eu
REACT_APP_HOST=apps.dev.graasp.eu
REACT_APP_VERSION=latest
REACT_APP_BASE=//$REACT_APP_HOST/$REACT_APP_APPS_DEVELOPER_ID/$REACT_APP_APP_ID/$REACT_APP_VERSION/
NODE_ENV=production
BUCKET=graasp-apps-dev
AWS_DEFAULT_REGION=us-east-1
AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID>
AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY>

Once you are ready to deploy your application to our production server, you will need to create a .env.prod file in your root folder following the patter below. Replace the value between <> with those that you received from our developers. Please make sure you do not commit or share the values between <> with anyone, as they are confidential.

REACT_APP_APPS_DEVELOPER_ID=<REACT_APP_APPS_DEVELOPER_ID>
REACT_APP_APP_ID=<REACT_APP_APP_ID>
REACT_APP_GRAASP_DOMAIN=graasp.eu
REACT_APP_HOST=apps.graasp.eu
REACT_APP_VERSION=latest
REACT_APP_BASE=//$REACT_APP_HOST/$REACT_APP_APPS_DEVELOPER_ID/$REACT_APP_APP_ID/$REACT_APP_VERSION/
NODE_ENV=production
BUCKET=graasp-apps-prod
AWS_DEFAULT_REGION=us-east-1
AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID>
AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY>

Installing Dependencies

Make sure you have node and yarn installed on your local machine otherwise go here and install them; then run yarn from the project directory to install all dependencies.

Starting the Server