Geospatial hunger & child stunting map + farmer marketplace for Rwanda
# The Challengers — GPT-Hub Advanced (Hackathon-ready)
This project is a competition-ready starter for the NISR Hackathon 2025. Key features included:
- Choropleth-style map for Rwanda districts (sample GeoJSON included). Replace with official NISR geojson for production accuracy.
- Farmer marketplace with localStorage persistence and an optional GitHub Issues backend (see notes below).
- Dashboard with national stunting rate and district bar chart.
- Weather forecast (Open-Meteo) per location/listing and simple agronomic advice for the next 3 days.
- Bilingual UI (English & Kinyarwanda) and accessibility improvements.
- Fully static (host on GitHub Pages for free).
## How to deploy (non-coder)
1. Create a GitHub repository (public) called `The-Challengers` (or your preferred name).
2. Upload all files in this ZIP to the repo root.
3. In GitHub: Settings → Pages → select branch `main` and folder `/ (root)` → Save.
4. Wait a few minutes. Visit `https:// .
github.io`.
## Data & Customization
- Replace `data/rwanda-districts-sample.geojson` with official district GeoJSON. Ensure each feature has a `properties.stunting` numeric field.
- Marketplace: listings are saved locally in browser storage. For persistence across users, configure a GitHub Action that creates Issues from POSTs or use Airtable/Sheets (free tiers).
## GitHub Issues Integration (recommended)
- Create a GitHub Personal Access Token (PAT) and save it as a repo secret. Use a small GitHub Action (e.g., `peter-evans/create-issue`) to create issues when repository dispatch events are sent from a proxy endpoint. This avoids exposing tokens in-browser. See GitHub Actions marketplace for examples.
## Notes on Weather Advice
- Uses Open-Meteo (no API key). The app fetches a 3-day forecast for chosen coordinates and applies simple rules to suggest actions (e.g., delay harvest in heavy rain). Review and refine advice logic with agricultural experts for production use.