Open data and performance hub for the City of Austin Transportation Department
Clone or download

README.md

Austin Transportation Data and Performance Hub

This repository houses the City of Austin Transportation Department's Data and Performance Hub, a public website which tracks the department's operational performance and curates access to key datasets.

This site is hosted at transportation.austintexas.io and uses Jekyll and Github Pages to create static pages.

Much of the content on the site is generated in-browser using D3js and jQuery to visualize data from the City of Austin Open Data Portal.

Quick Start

  1. Install Git and Jekyll.

  2. cd to the directory where you want to check-out the site, and clone it (git clone https://github.com/cityofaustin/transportation)

  3. cd to the directory that contains the cloned repository, and run jekyll serve to start the webserver

  4. Navigate to http://localhost:4000 in your browser to view the site hosted-locally

Optional Advanced Javascript

If you will be working on any data dashboards that utilize Javascript ES6+ and/or React.js, we have a build setup for transpiling modern JS into a cross-compatible bundle.

  1. run npm install to download and install javascript dependencies from package.json

  2. run webpack --watch. As files are modified, a new bundle will be automatically generated.

  3. (optional) Inspect webpack.config.js and create a new entry to start a new bundle.

TL;DR

  1. run jekyll serve --watch in one Terminal
  2. run webpack --watch in a separate Terminal

Webpack will watch for changes to your source javascript/react files and output a new bundle. Jekyll will watch for new bundles and regenerate all the static assets.

Environments

Production

Contributing

Public contributions are welcome! Assign pull requests to @johnclary.