MbazaCodes/Winga-App-V2

Tanzania Services Guide Management # WINGA APP V2 — Tanzania's Trusted Shopping Guide Platform Connects **customers** with **Wingas** (verified shopping guides) for errands, shopping, and delivery across Tanzania. ## Platform Structure ``` WINGA APP V2/ ├── 📱 customer-pwa/ Customer PWA (Next.js 16 + React 19) ├── 🛠️ winga-pwa/ Winga (Guide) PWA (Next.js 16 + React 19) ├── 💻 admin-web-app/ Admin Dashboard (Next.js 16 + React 19) ├── 📲 mobile-app/ Mobile App (Flutter — Planned) ├── 🗄️ supabase/ Database, Migrations, Edge Functions │ ├── config.toml Supabase local config │ ├── migrations/ 12 SQL migrations (schema, RLS, triggers, fixes) │ ├── functions/ 4 Edge Functions (auth-secured) │ └── seed/ Seed data ├── docker-compose.yml Full local stack (Postgres + Studio + pgAdmin) └── setup-local.sh One-command local setup ``` ## Quick Start (Local Development) ### Option A: Using Setup Script (Recommended) ```bash git clone github.com cd Winga-App-V2 chmod +x setup-local.sh ./setup-local.sh ``` ### Option B: Manual Setup ```bash # 1. Start Supabase Local npx supabase start # Or: docker-compose up -d # 2. Install dependencies cd customer-pwa && npm install && cd .. cd winga-pwa && npm install && cd .. cd admin-web-app && npm install && cd .. # 3. Start apps (each in its own terminal) cd customer-pwa && npm run dev # localhost cd winga-pwa && npm run dev -- -p 3002 # localhost cd admin-web-app && npm run dev # localhost ``` ### Local URLs | Service | URL | |---------|-----| | Customer PWA | localhost | | Winga PWA | localhost | | Admin Dashboard | localhost | | Supabase API | localhost | | Supabase Studio | localhost | | pgAdmin | localhost | ### Demo Credentials | Platform | Login | OTP | |----------|-------|-----| | …