Trip Cluster Tool

Trip Cluster Tool is an exploratory data visualization of traffic flow in the Edmonton Central Metropolitan Area.

(Trip Cluster Tool is a web app built with React, deck.gl, and react-map-gl)

Website

https://trip-cluster-tool.herokuapp.com

Note: All modern browsers except Internet Explorer are supported

Development

Setup

Requirements

• Node.js >=12.0.0
• npm >=6.0.0 (included with Node.js)

  Install Dependencies

  npm install

  Set Environment Variables

  Create a .env file in the project root directory.
  Inside, add your Mapbox API Access Token:

  MAPBOX_TOKEN=...

  Update Data

  To update the data of this tool, please use the trip-cluster-tool-data project.

When new data is produced, replace the appropriate file in the src/client/assets/data directory.

Build

Note: Code building/bundling is performed using Webpack

Development Mode

(The code is not minified and has access to source map tools and hot module replacement)

npm run build:dev

Production Mode

(The code is minified and does not have access to source map tools or hot module replacement)

npm run build:prod

Run

Note: Setup must be completed and the code must be built in order to run

npm start

Deploy

Every push to the master branch will be deployed as part of a continuous delivery workflow.

Configuration for this process is found in .github/workflows/main.yml (using GitHub Actions).