nyuchi/mukoko-lingo

Language learning app for Zimbabwe and English and Chinese travellors # Mukoko Lingo **AI-first, skills-based multilingual language learning platform** — for individuals, schools, and businesses across Africa. Learn Shona, Ndebele, Chinese, and English with AI-powered tutoring by Shamwari. Built with Expo SDK 57 / React Native, Next.js, MongoDB, WorkOS AuthKit, Vercel Serverless, and Anthropic Claude. **Parent Company**: Nyuchi Africa | **Registry**: registry.mukoko.com ## Quick Start ```bash # Install dependencies npm install # Copy environment variables cp .env.example .env.local # Start mobile dev server npx expo start # Start web app (separate terminal) cd web && npm install && npm run dev ``` ## Environment Setup Copy `.env.example` to `.env.local` and fill in: - `MONGODB_URI` — MongoDB connection string - `WORKOS_API_KEY` / `WORKOS_CLIENT_ID` — WorkOS AuthKit credentials - `ANTHROPIC_API_KEY` — Anthropic Claude API key (server-side only) - `EXPO_PUBLIC_API_BASE_URL` — Vercel API base URL See `.env.example` for the complete list. ## Two Apps, One Backend | Platform | Technology | For | |----------|-----------|-----| | **Mobile** (`/app`) | Expo/React Native | Individuals learning on the go (iOS + Android) | | **Web** (`/web`) | Next.js + Tailwind | Individuals, schools, businesses on any browser | | **API** (`/api`) | Vercel Serverless | Shared backend (52 endpoints) | Both apps call the same API routes. The web app includes all learner features plus admin/org management. ## Key Features - **Daily Lessons** — Smart phrase selection (5 phrases/day) with flash cards and mini-quizzes - **230+ Phrases** — 4 languages with pronunciation guides and cultural context - **Shamwari AI Tutor** — Claude-powered tutor that adapts to learner proficiency - **Skills & Assessments** — 5 core skills with diagnostic, formative, and summative tests - **Classes & Assignments** — Teachers create classes, assign phrases, track student progress - **OneRoster Integration** — Sync school rosters from Clever, ClassLink, PowerSchool - **Co …