# FarmConnect Ghana
A mobile-first PWA connecting Ghanaian smallholder farmers directly to buyers, live market prices,
and AI-powered agricultural advisory — a University of Ghana capstone project (Group "Angry Nerds").
This repo implements the system described in the project SRS (`../uploads/FarmConnect_Ghana_SRS_Angry_Nerds.docx`),
with a few deliberate departures agreed on during planning:
- **Payments are not gateway-integrated at all.** A farmer registers their Mobile Money number,
network (MTN/Telecel/AirtelTigo), and registered account name. A buyer sees those details on
checkout, sends the money directly via their own phone (outside the app), then submits a
transaction ID for the farmer to manually confirm against their own Mobile Money history. No
Paystack, no MoMo API integration, no automated charge/transfer — see **Payments** below.
- **Market prices** are served by our own `PriceFeed` service with a realistic seeded dataset — no
public Ghana Commodity Exchange API actually exists to integrate with.
- The frontend is a **plain React web PWA** (Vite + React + TypeScript), not literally "React Native",
despite the SRS's phrasing — this gives a real installable/offline PWA without native tooling.
- **The AI advisory chatbot runs on Google Gemini, not Claude/Anthropic.** Gemini has a genuinely
free developer-side API tier (no credit card, no per-end-user account scheme); it fits a chatbot
used by many farmers/buyers far better than alternatives that push the AI cost or a login
requirement onto each end user.
The `FarmConnect Ghana.dc.html` prototype one directory up is a UX/flow/copy reference only — screen
names, i18n keys, and the design palette are borrowed from it; nothing there is pixel-matched.
## Status: Phase 7 (offline caching, full i18n pass, accessibility pass) done
Auth, listings, and the full order lifecycle are live end-to-end using **manual Mobile Money
reconciliation instead of a payment gateway**:
1. A farmer must link Mobile Money de …