Arn-The-Wolf/ingoboka-platform

Ingoboka — Next.js 14 PWA frontend for the digital microinsurance platform. Citizen policy wallet, claims, and insurer portal. Built for Rwanda. 🇷🇼 # Ingoboka Platform - Frontend > Digital microinsurance platform for Rwanda - Empowering citizens with affordable insurance ## 🌟 Overview Ingoboka is a B2B2C digital insurance platform designed for Rwanda, enabling: - **Citizens** to enroll in affordable micro-insurance products - **Insurers** to manage product catalogs and process claims - **Agents** to assist customers with enrollment - **Platform Admins** to onboard partners and monitor the ecosystem ### Key Features ✅ Multi-role authentication (Citizen, Insurer, Agent, Admin) ✅ Product catalog with daily/weekly/monthly premiums ✅ Needs assessment with AI recommendations ✅ Digital policy cards with QR verification ✅ Claims submission and tracking ✅ Mobile money payment integration ✅ Bilingual support (Kinyarwanda & English) ✅ Progressive Web App (PWA) ready ✅ Responsive design (mobile-first) --- ## 🚀 Quick Start ### Prerequisites - **Node.js** 20+ (Download) - **npm** or **yarn** - **Backend API** running (see `.tmp-api/README.md`) ### Installation ```bash # 1. Install dependencies npm install # 2. Set up environment variables cp .env.example .env.local # 3. Configure API endpoint # Edit .env.local: NEXT_PUBLIC_API_BASE_URL=localhost # 4. Start development server npm run dev ``` The app will be available at **http://localhost:3000** --- ## 📦 Project Structure ``` src/ ├── app/ # Next.js App Router │ ├── [locale]/ # Internationalized routes │ │ ├── (admin)/ # Platform admin dashboard │ │ ├── (agent)/ # Agent workspace │ │ ├── (auth)/ # Login, register, verify │ │ ├── (citizen)/ # Citizen dashboard & features │ │ ├── (insurer)/ # Insurer portal │ │ └── (marketing)/ # Public landing pages │ ├── api/ # API routes (if needed) │ └── globals.css # Global styles │ ├── components/ # React components │ ├── auth/ # Authentication components │ ├── ci …