ecosystem for buying and selling raw goods in Zimbabwe
# AgriLink MVP
### A peer-negotiated agricultural marketplace for African markets
Built on the principle: **Africa is not poor β Africa is poorly optimised.**
This platform removes the friction between farmers and buyers by building trust, enabling direct price negotiation, and creating transparent delivery systems.
---
## π How to run
No build step needed. Pure HTML + CSS + JS.
**Option 1 β VS Code Live Server (recommended)**
1. Open the `agrilink/` folder in VS Code
2. Install the "Live Server" extension (ritwickdey.LiveServer)
3. Right-click `index.html` β **Open with Live Server**
4. Opens at `
127.0.0.1`
**Option 2 β Simple HTTP server**
```bash
cd agrilink
python3 -m http.server 8080
# Open
localhost
```
**Option 3 β Node http-server**
```bash
npm install -g http-server
cd agrilink
http-server -p 8080
```
> β οΈ Do NOT open index.html directly as a file:// URL β the map tiles and Google Fonts need a server.
---
## π Project structure
```
agrilink/
βββ index.html # All screens (splash, auth, app)
βββ css/
β βββ main.css # Full stylesheet
βββ js/
β βββ data.js # Mock data (farmers, listings, negotiations)
β βββ map.js # Leaflet map logic
β βββ app.js # All app logic
βββ README.md
```
---
## β
What's built in this MVP
### Screens
- **Landing page** β hero, stats, CTAs
- **Registration** β role selection (farmer / buyer), form, doc upload flow
- **Login** β form + demo login
- **Verification pending** β document upload simulation, status tracker
### App tabs
- **Farm Map** β interactive Leaflet map of Zimbabwe
- Pins for all 8 mock farmers
- Filter by produce type (maize, tomato, soy, potato, tobacco)
- Click any pin β farm side panel with listings
- "Make an offer" directly from the map
- **Browse Produce** β all listings grid
- Search/filter by name, farm, location
- Verified badge on listings
- "Make an offer" and "View details" per listing
- **Negotiations** β live negotiatio β¦