Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Graasp App Starter: React Framework

Codeship Codacy Badge Codacy Badge Prettier Conventional Commits License

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

Navigate to the cloned or forked project directory using the command line, type npm start and the project will automatically run on localhost:3000.

About

An application starter kit for Graasp based on the React framework.

Resources

License

Stars

Watchers

Forks

Packages

No packages published