john11e/Somaplus

A project aimed at improving accessibility and quality of education in Kenya # Mstari — Pathways Edu-Tech Group ### *The Blueprint for Your Future.* A comprehensive CBC/CBE-aligned educational platform for Kenya, covering PP1 through University. ## Tech Stack | Layer | Technology | |---|---| | Mobile | Flutter 3.x (Android + iOS) | | Web | Next.js 14 (App Router, TypeScript) | | API | Fastify 4 (Node.js, TypeScript) | | Database | PostgreSQL 16 (Supabase) | | Cache | Redis (Upstash) + BullMQ | | Auth | Supabase Auth + Africa's Talking SMS | | Storage | Supabase Storage + Cloudflare R2 | | Hosting | Fly.io (NBO region) + Vercel | ## Monorepo Structure ``` mstari/ ├── database/ # PostgreSQL migrations + seeds ├── api/ # Fastify REST API ├── web/ # Next.js 14 web application ├── mobile/ # Flutter mobile app └── docker-compose.yml ``` ## Quick Start ### Prerequisites - Node.js 20+, pnpm 8+, Flutter 3.x, Docker ### 1. Database ```bash docker-compose up -d postgres redis pnpm db:migrate pnpm db:seed ``` ### 2. API Server ```bash cd api && pnpm install && pnpm dev # Runs on localhost ``` ### 3. Web App ```bash cd web && pnpm install && pnpm dev # Runs on localhost ``` ### 4. Flutter App ```bash cd mobile && flutter pub get && flutter run ``` ## Environment Variables Copy `.env.example` to `.env` in each package directory. ## KICD Alignment All curriculum terminology follows KICD 2026 CBC/CBE guidelines: - Early Years (PP1-PP2): Learning Areas - Primary/Junior (G1-G9): Strands & Sub-strands - Senior School (G10-G12): Pathways (STEM / Social Sciences / Arts & Sports Science) - University: Common Units + Core Units ## License Copyright © 2026 Pathways Edu-Tech Group. All rights reserved.