Cybergreen stats site (new)
Clone or download
Latest commit 85bd048 Oct 4, 2018

Build Status


To build and view the app:

  1. Clone the repo

    git clone --recursive
  2. Install dependencies

    [sudo] npm install
  3. Create a database and set configuration [see below]

  4. Run the app. From the base directory:

    heroku local
  5. Visit the running app in your browser at http://localhost:5000/

Setting up a Database

There are two options:

  • A local database - this is needed if you are doing local development and testing. See next section.
  • The online development database - this is for demo-ing and testing against the full dataset. You can connect direct to the live development using your .env. You will need to get the connection details from the tech lead.

Creating a local database

We use postgresql 9.5 for local development. Plese follow instalation instructions here

Create the user and database

$ psql -U postgres -c "create user test_user password 'secret' createdb;"
$ psql -U postgres -c "create database testdb owner=test_user;"

Run aggregation script

$ pip install -r setup/requirements.txt
$ python setup/

Deployment to Heroku

Note that you will need to install the Heroku toolbelt to carry out the heroku commands below.

Create the application on Heroku

Skip this step if the application is already deployed

This is heavily based on this tutorial.

    # replace {app-name} with the name of your app
    heroku create {app-name}
    git push {remote-name} master
    # now point at our config
    heroku ps:scale web=1

Note: If not set, remote-name by default, is “heroku”.

To deploy (already created):

Push to heroku git repo:

    git push {remote-name} master

Note: if didn't do the create you will need to add the remote:

    git remote add {remote-name}{app-name}.git

Adding collaborators:

    heroku sharing:add

Setting the domain name

Do the following:

    heroku domains:add {your-domain-name}

Define config vars to connect to RDS database in .env for heroku

Construct URI with following format:

# example

Now CNAME your domain to {myapp}