Starting up


  • Have PostgreSQL installed and a local database called elections
  • Have python3 installed
  • Have virtualenv installed
  • Have jq installed (brew install jq)
  • Have topojson and topojson-simplify installed globally


  1. Clone this repo to a local directory
  2. Start a virtualenv in the directory
$ virtualenv -p python3 venv
  1. Start the virtual environment and source any environment variables.
$ source venv/bin/activate
$ source .env
  1. Bootstrap the database.
$ fab data.bootstrap_db
  1. Move to theshow/staticapp directory and yarn install node dependencies.
$ yarn
  1. Run gulp to start developing.
$ gulp