Poultry coordination and market access platform for Lesotho. Connects small-scale farmers to buyers, manages orders, and improves farming standards through data. Built with React + Vite.
# Khokahano Agri Systems
> **Connect. Coordinate. Grow. Succeed.**
Khokahano Agri Systems is a poultry coordination and market access platform for Lesotho. It connects small-scale poultry farmers to markets, resources, and buyers — while collecting farming data to improve production standards and livelihoods across the country.
---
## What this platform does
This is not just a marketplace. It is a full ecosystem with two interconnected systems:
### 1. Marketplace
Buyers browse and order poultry products directly from verified local farmers. Products are filtered by the buyer's district automatically using geolocation. The cart, checkout, and order tracking flows are fully functional.
### 2. Farmer Portal
Farmers receive orders, manage their status through a live dashboard, and get escalation alerts if they don't respond within 10 minutes. Khokahano staff are notified automatically for any overdue orders.
---
## Live routes (development)
| URL | Purpose |
|-----|---------|
| `
localhost` | Buyer marketplace |
| `
localhost` | Farmer order dashboard |
| `
localhost` | Khokahano staff alerts page |
Open the marketplace and farmer dashboard in separate browser tabs to see the full order flow in real time.
---
## Features
### Marketplace (buyer side)
- Product listings with real farm photography
- Location-based filtering — auto-detects buyer's district on first visit (with consent)
- Search, category filter, and sort
- Bilingual — English and Sesotho, toggle in navbar
- Shopping cart persisted in localStorage
- Checkout with delivery method (pickup or delivery) and payment method (M-Pesa, EcoCash, Card)
- My Orders panel — live order status tracking, updates every 3 seconds
- Toast notifications when farmer changes order status
### Farmer dashboard
- Live order feed with 10-minute countdown timer on pending orders
- Order status progression: Pending → Accepted → Preparing → Ready → Completed
- Decline …