utayannaidoo/K53-mentor-ai

An AI-powered study platform for the South African K53 learner's and driver's licence tests. It diagnoses a learner's weak spots, builds a personalised spaced-repetition plan, and coaches them with an AI tutor not just another question bank. # K53 Mentor AI An AI-powered study platform for the South African **K53 learner's and driver's licence** tests. It diagnoses a learner's weak spots, builds a personalised spaced-repetition plan, and coaches them with an AI tutor — not just another question bank. Built with **Next.js 15 (App Router) · TypeScript · Tailwind CSS · Supabase · Anthropic/OpenAI AI cascade · Paystack billing**. > Not affiliated with or endorsed by the RTMC. Content is aligned to the structure of the official > K53 manual; it is not government-issued material. --- ## ✨ Features - **AI diagnostic** — a 15-question adaptive assessment that produces a **readiness score**, a **predicted pass probability**, and a per-category weakness breakdown. - **Personalised daily plan** — due flashcards, targeted practice on your weakest category, and a scenario, sized to a "10 minutes a day" habit. - **Spaced repetition** — SM-2 flashcards with `Again / Hard / Good / Easy` and per-category mastery. - **AI Tutor** — a ChatGPT-style coach that explains the *why*, anchored to the exact question or card you're stuck on. Powered by an Anthropic → OpenAI provider cascade, with a genuinely useful rule-based fallback when no key is set. - **Scenario learning** — branching, real-world situational judgement (traffic circles, hazards, dead robots) with consequence feedback. - **Mock exam** — full 68-question / 51-to-pass simulation with category breakdown and mistake review. - **Driver's-licence prep** — step-by-step "cook-mode" yard-test guides (parallel parking, alley docking, three-point turn, inspection, observation). - **Retention** — streaks with a weekly *freeze* (forgiveness), a readiness trend, and proactive AI nudges when you're repeatedly missing a category. - **Subscriptions** — Free / Premium / Premium Plus with real feature-gating and a Paystack checkout route. - **Calm, premium UI** — light/dark, mobile-first, data-saver mode, accessible. --- ## 🚀 Getting started ```bash npm install npm run d …