w-yidne/ai-edu

AI tutor demo for Grade 11 Ethiopian students (Math/Physics/Chem/Bio, EUEE-aligned, EN/AM/OM) # Hasesa — Demo An AI tutor demo for Grade 11 Ethiopian students. This is a **demo shell** of the MVP — most screens described in the requirements exist with working interactions, but content is sample-only and there is no real backend. ## What's in this demo - **Landing** — mission, differentiation, value props - **Lessons** — sample content for all 4 subjects (Math, Physics, Chemistry, Biology), filterable, with MoE codes and EUEE topic tags - **Lesson detail** — sections, worked example, in-lesson quiz, AI-generated practice questions on demand - **AI Tutor** — Groq (Llama 3.3 70B), grounded in lesson context with citation, refuses off-topic - **Trilingual UI** — English, Amharic, Afaan Oromo for all UI strings; lesson bodies in English - **Accounts** — sign up as student or teacher, username + password (demo: stored in browser only) - **Onboarding** — pick subjects, optional under-18 privacy notice, short diagnostic quiz - **Student dashboard** — recommended next lessons (weighted by mastery gap × EUEE weight), per-topic mastery bars - **Mock test** — EUEE-style mock per subject, scored with per-topic breakdown - **Teacher dashboard** — create class codes, see aggregate (never individual) mastery + weakest topics - **Class codes** — students join via code, contribute to class aggregate - **PWA** — installable manifest, service worker (network-first HTML, cache-first static) ## Stack - Next.js 16 (App Router) + React 19 + TypeScript - Tailwind CSS v3 - Groq API (Llama 3.3 70B) — free tier, OpenAI-compatible - All state in localStorage — there is no server-side persistence ## Local development ```bash npm install cp .env.example .env.local # add your GROQ_API_KEY to .env.local (free key at console.groq.com) npm run dev ``` Open localhost. ## Deploying to Vercel 1. Push to GitHub. 2. Import the repo on vercel.com. 3. Add env var `GROQ_API_KEY` in project settings. 4. Deploy. ## What's intentionally NOT in this demo (still spec, n …