Daryl-Tawana/GPA-Platform

# ZARIP — Zimbabwe Agricultural Retained Income Platform > **"How much income does the tobacco grower actually retain after all costs and deductions?"** A static, client-side dashboard modelling net retained income for Zimbabwe smallholder tobacco growers. Built as an academic research tool for the IPEC climate risk and agricultural income research programme. --- ## Live Demo Deploy to GitHub Pages — no server required. --- ## Project Structure ``` zarip-dashboard/ ├── index.html Main dashboard (all sections) ├── style.css Stylesheet — earth-toned agricultural theme ├── app.js All calculation and rendering logic ├── data/ │ └── grower-data.json Static sample data (6 grower/scenario records) └── README.md ``` --- ## Features - **Income statement** — Gross revenue → production costs → contract recovery → net retained income - **Waterfall chart** — Visual income flow from revenue to net retained - **Cost breakdown** — Bar chart disaggregating all variable costs - **Break-even analysis** — Minimum price per kg and yield per hectare - **Scenario comparison** — Best, base, and worst case - **Interactive sensitivity sliders** — Adjust price, yield, and cost shocks in real time - **Price sensitivity table** — Net retained income at ±30% price shifts - **CSV export** — Download summary for any selected grower - **Full documentation** — Formulas, variable definitions, assumptions, limitations - **Responsive** — Works on desktop and mobile --- ## Deploying to GitHub Pages 1. Fork or clone this repository. 2. Go to **Settings → Pages** in your GitHub repository. 3. Set source to `main` branch, root folder `/`. 4. GitHub will publish the site at `https:// .github.io/ /`. > **Important:** The dashboard must be served over HTTP/HTTPS (not opened as a local `file://` URL) for the `fetch()` call to load `data/grower-data.json`. GitHub Pages handles this automatically. > > **Note:** The sample dataset uses USD-equivalent …