# Shamba AI
Shamba AI is a clickable mobile-first prototype designed for Kenyan farmers to estimate their farm size, calculate ploughing cost, and simulate a payment flow using M-Pesa-style UX.
## Project Summary
The app is built as a front-end prototype to demonstrate the user journey for:
- logging in or creating an account
- onboarding with farmer profile details
- measuring a farm boundary by tapping points on a map canvas
- viewing the estimated area in acres
- calculating ploughing cost based on a rate-per-acre slider
- paying using an M-Pesa simulation flow
- reviewing records, insights, and payment history
## Current Status
This repository currently contains a static prototype with no backend, database, or real payment integration. It is a UI/UX proof of concept intended to validate the product flow and business logic.
## Core Features
### 1. Splash and Authentication
- Splash screen introduction
- Login screen with phone number and PIN entry
- New-user onboarding flow
### 2. Farmer Profile Management
- Name, county, town, farm name, and size estimate
- Editable profile details
- Farm record snapshots
### 3. Boundary Measurement Simulation
- Farmers tap corner points on a boundary map
- The prototype calculates a preview area using a Shoelace-based polygon area formula
- Area is shown in acres
### 4. Cost Estimation
- Users adjust a rate-per-acre slider
- Estimated total cost updates instantly
- Results can be saved to the dashboard
### 5. M-Pesa Payment Simulation
- Phone input validation for M-Pesa-style number entry
- Simulated STK push process using timeouts
- Payment receipt generation and payment history listing
### 6. Insights and Records
- Payment trail
- Farm measurement records
- Savings/season cost comparison summary
## Tech Stack
- HTML
- CSS
- Vanilla JavaScript
- SVG for map and boundary visualization
- Google Fonts for typography
## File Structure
- index.html — all UI, styling, and app logic in one static file
## How to Run …