Bradford 2025 data dashboard

TL;DR: This site depends on data which is updated by a Github Action overnight. Assuming you have a working deno environment, the task deno task daily will prepare the site for build. For running the local version you probably want deno task dev.

Pre-requisites

1. Ensure that you can run ssh git@github.com successfully. If not, follow instructions to Add a new SSH key to your GitHub account.
2. Install Deno, Python and Pipenv for your platform
3. Run pipenv install

Minimal build steps

Prepare the build using this - probably once a day.

1. Run git pull --rebase
2. Run pipenv shell

If you want to run the pipelines for any reason (maybe having changed some of the code), run the following:

3. Run deno task data:pull
4. Run deno task data:pipeline

The dev site is built from the main branch, but generates all pages with draft: true set. To build and serve the dev site, run

deno task dev

Troubleshooting

Make sure you've installed all the required libraries

pipenv sync

Deno issues

If you experience errors such as

[ERROR] Could not resolve "d3-zoom" [plugin deno-loader]

run deno install to make sure Deno installs various dependencies. If that doesn't work, try editing deno.jsonc and change "nodeModulesDir": "manual" to "nodeModulesDir": "auto".