Interactive dashboard for Nigeria zero-dose vaccination study: ML + ABM + CNA pipeline results
# website/ — zero-dose v2 dissemination
Two dissemination assets coexist here:
## Streamlit dashboard
The 12-page interactive Streamlit dashboard lives one level up at `../app/`. To run locally:
```bash
cd ../app
pip install -r requirements.txt
streamlit run Home.py
```
## React / Vite scrollytelling site
This folder (`website/`) contains the React + Vite + D3.js + Tailwind scrollytelling site. To develop:
```bash
npm install
npm run dev
```
To build for deployment:
```bash
npm run build
```
### GitHub Pages deployment
This folder is configured to deploy the React/Vite site with GitHub Actions:
- Workflow: `.github/workflows/deploy.yml`
- Trigger: pushes to `main` and manual `workflow_dispatch`
- Build output: `dist/`
- Pages source: set the repository's **Settings → Pages → Build and deployment → Source** to **GitHub Actions**
The workflow sets `VITE_BASE_PATH` to `/${{ github.event.repository.name }}/`, so the built asset paths and React router basename follow the repository name. If you deploy from a custom domain or a user/organisation root site, change `VITE_BASE_PATH` in the workflow to `/`.
The `postbuild` script copies `dist/index.html` to `dist/404.html` so direct links such as `/story`, `/policy`, and `/explorer/descriptive` work on GitHub Pages.
The site reads pre-computed JSON data from `public/data/`, generated by the scripts in `website/scripts/`. To refresh the data after re-running the pipeline:
```bash
python scripts/prepare_website_data.py
python scripts/precompute_scenarios.py
```
The data-prep scripts read from the v2 canonical layout (`outputs/tables/`, `outputs/figures/`, `outputs/models/`, `outputs/twin/`) rather than the older `outputs/stage{1,2,3}/` layout used in v1.
## Quarto static fallback
For reviewers who can't run the live dashboards, `website/quarto/` is a Quarto book that mirrors the pipeline's outputs in static HTML + PDF:
```bash
cd quarto
quarto render
```
Output renders to `quarto/_book/`.
## Deployment opt …