Judhunja/SomaNow

A comprehensive Progressive Web App for Kenya-focused education # Elimu Hub - Community-Powered Learning Platform > **Empowering Education in Kenya through Technology** 🇰🇪 > Supporting UN SDG 4: Quality Education for All ## 🎯 Overview Elimu Hub is a Progressive Web App (PWA) designed to democratize education access in Kenya through: - **Peer Learning**: Study circles, mentorship, and teaching points system - **Adaptive AI Tutor**: Personalized learning paths and instant Q&A support - **Offline-First Design**: Works without internet via service workers and IndexedDB - **USSD Integration**: Parents can check progress via `*789*12349#` on any phone - **Practical Skills**: Financial literacy, digital skills, entrepreneurship, and agri-tech ## 🏗️ Architecture ``` ┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ Frontend │ │ Supabase │ │ Africa's │ │ (Vite/React) │◄──►│ (Database) │ │ Talking USSD │ │ + PWA Cache │ │ + Edge Funcs │ │ │ └─────────────────┘ └──────────────────┘ └─────────────────┘ ▲ ▲ ▲ │ │ │ ▼ ▼ ▼ ┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ Service │ │ Real-time │ │ AI Client │ │ Worker │ │ Subscriptions │ │ (Mock/Real) │ │ (Offline) │ │ (Chat/Sync) │ │ │ └─────────────────┘ └──────────────────┘ └─────────────────┘ ``` ## 🚀 Quick Start ### Prerequisites - Node.js 18+ - Supabase CLI - Git ### Local Development 1. **Clone and Install** ```bash git clone cd SomaNow cd web && npm install ``` 2. **Set up Supabase** ```bash npx supabase init npx supabase start npx supabase db reset ``` 3. **Configure Environment** ```bash cp .env.example .env.local # Fill in your Supabase project URL and anon key ``` 4. **Start Development** ```bash # Terminal 1: Frontend cd web && npm r …