kitessafikadu/nurai

AI-powered reproductive healthcare platform focused on helping women in Sub-Saharan Africa make informed contraceptive choices through a private, multilingual, low-bandwidth, and offline-friendly experience. # NuraAI Private guidance for smarter health choices. NuraAI is a startup-grade reproductive healthcare platform designed for women in Sub-Saharan Africa, with a smartphone experience in Flutter and low-bandwidth access through USSD and SMS. This monorepo ships: - `mobile`: Android-first Flutter app with clean architecture and BLoC state management - `backend`: NestJS API, AI orchestration, USSD handlers, auth, analytics, and Prisma - `web`: Next.js web portal with role-based `/admin` and `/chw` routes plus RBAC - `packages/ui`: Shared design tokens and React UI primitives - `packages/shared`: Business constants, clinic/method metadata, and AI helper logic - `packages/types`: Shared TypeScript contracts used by API and web apps ## Architecture Overview - Mobile uses repository-driven feature modules, local persistence, and a sync queue for offline assessments, reminders, and chat drafts. - Backend uses NestJS modules with Prisma, JWT auth, consent tracking, encrypted fields, audit logging, and rate limiting. - AI recommendations combine guideline-based scoring with LLM-generated counseling explanations, myth-busting, translation, and side-effect support. - USSD delivers short telco-ready counseling flows under `*345*88#`, keeping responses under 160 characters. - Web dashboards share a common token system and typed API clients. ## Quick Start ```bash pnpm install docker compose up -d db pnpm --filter backend prisma:migrate pnpm seed pnpm dev ``` ## Apps ### Backend ```bash pnpm --filter backend dev ``` API base: `localhost` ### Web Portal ```bash pnpm --filter web dev ``` ### Mobile ```bash cd mobile flutter pub get flutter run ``` ## Production Concerns Included - Anonymous mode and OTP auth - Consent capture and audit logs - Encrypted profile fields - Offline-first local persistence strategy - Notification abstractions for FCM and SMS - Dockerized local stack - CI pipeline scaffold ## Docs - Architecture - API - Deployment