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 54 / React Native, Next.js, Supabase PostgreSQL, Stytch Auth, Vercel Serverless, and Anthropic Claude.

Parent Company: Nyuchi Africa | Registry: registry.mukoko.com

# 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

Copy .env.example to .env.local and fill in:

• SUPABASE_URL / SUPABASE_SERVICE_ROLE_KEY — Supabase PostgreSQL
• STYTCH_PROJECT_ID / STYTCH_SECRET — Stytch auth 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.

Both apps call the same API routes. The web app includes all learner features plus admin/org management.

• 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
• Content Moderation — Local guardrails + AI-based + prompt injection detection
• Admin Dashboard — Users, phrases, moderation, guardrails, analytics, API keys (web only)

# Mobile development
npx expo start              # Dev server (mobile + web)
npx expo start --ios        # iOS simulator
npx expo start --android    # Android emulator

# Web development
cd web && npm run dev        # Next.js dev server

# Build & Deploy
npm run build:web           # Export Expo web build for Vercel
cd web && npm run build     # Build Next.js web app

# Testing & Quality
npm test                    # Run all tests (18 suites, 226 tests)
npm run test:coverage       # Tests with coverage report
npx tsc --noEmit            # TypeScript type check

Three Supabase PostgreSQL schemas:

Phrases are normalized: lingo.phrase (metadata) + lingo.translation (1 row per language per phrase). Adding a new language is just INSERT — no schema change.

GitHub Actions runs on push to main/feature/* and PRs to main:

1. TypeScript Check — npx tsc --noEmit
2. Jest Tests — npm test -- --ci --coverage
3. Build Web — npx expo export --platform web

• ARCHITECTURE.md — 5-layer component hierarchy and data layer awareness
• CLAUDE.md — Developer guide & full architecture reference
• BRANDING.md — Brand guidelines & Five African Minerals design system
• SECURITY.md — Security architecture
• CONTRIBUTING.md — Contribution guidelines
• CHANGELOG.md — Version history

MIT