Gacaca6/Learn4Africa

Free AI-powered learning platform for Africa # Learn4Africa **Free AI-powered learning platform for Africa.** *"Zigama" means "to understand deeply" — because true education is not about memorising, it is about seeing the world through a new lens.* ## Quick Start ```bash git clone github.com && cd Learn4Africa npm install # installs Next.js + Convex deps cp .env.example .env.local # fill in AUTH_SECRET + Google OAuth npx convex dev # links this repo to your Convex deployment # (writes NEXT_PUBLIC_CONVEX_URL into .env.local) npm run dev:all # Next.js on :3000 + Convex watcher open localhost ``` Deployment: **Vercel** (frontend) + **Convex Cloud** (backend, DB, functions). See `STAGE1.md` for step-by-step deploy. ## Feature status The platform is a work in progress. The table below is intentionally blunt about what works today and what is stubbed. Everything marked **Live** is called by the frontend and verified end-to-end. **Beta** means wired up but rough. **Stub** means a route or UI exists but is not wired. | Feature | Status | Notes | | -------------------- | ------ | --------------------------------------------------------------------------------- | | Reading | Live | Rendered inside the course viewer (`/course/[id]`) and track modules | | Flashcards | Live | Backend `/api/v1/flashcards` + course-viewer tab | | Quizzes | Live | Backend `/api/v1/quizzes` + course-viewer tab | | Podcasts | Beta | Browser Web Speech API reads Mwalimu aloud; no server TTS needed | | Comics | Stub | Removed in the Claude-only refactor; may return as Claude-drawn ASCII art | | Games …