thomaslorincz / trip-cluster-tool

An exploratory data visualization of traffic flow in the Edmonton Central Metropolitan Area

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).