# πΎ Kisii AgriPrice - SMS Market Prices for Farmers
**Live Demo:**
kisii-agri-sms.onrender.com
Daily SMS market price updates for small-scale farmers in Kisii, Kenya.
---
## π Table of Contents
- The Problem
- The Solution
- Features
- Tech Stack
- Demo Credentials
- Installation
- API Endpoints
- Project Structure
- Business Model
- Roadmap
---
## π― The Problem
Small-scale farmers in Kisii lose 20-40% of their income by selling crops without knowing current market prices. Middlemen exploit this information gap, buying low from farmers and selling high at markets.
**Current challenges:**
- No reliable source for local Kisii market prices
- Existing apps are Kenya-wide (not local enough)
- Many farmers don't have smartphones
- Extension officers reach only a fraction of farmers
---
## β
The Solution
**Kisii AgriPrice** delivers daily SMS updates with actual Kisii local market prices to ANY mobile phone - no smartphone or internet required.
**Key differentiators:**
1. **Kisii-specific** - Local market prices, not generic national data
2. **SMS-first** - Works on feature phones (90%+ rural penetration)
3. **Focused** - Only market prices (not bloated with unused features)
4. **Affordable** - 50-100 KES/month per farmer
---
## π Features
### For Farmers (Public)
β
**SMS Price Updates** - Daily market prices via text message
β
**Free Trial** - Test SMS service on homepage
β
**Simple Registration** - Just phone number + crops grown
β
**No App Required** - Works on any mobile phone
### For Admin
β
**Secure Authentication** - Password-protected admin panel
β
**Price Management** - Update 6 crop prices (maize, beans, tomatoes, bananas, potatoes, avocados)
β
**Farmer Dashboard** - View, search, and manage registered farmers
β
**SMS Logs** - Track delivery status and success rates
β
**Stats Dashboard** - Real-time metrics (total farmers, SMS sent, success rate)
β
**Bulk SMS** - Send updates to all farmers with one click
---
## π Tech Stack
**Backend β¦