AI-powered learning diagnostics and personalized study plan generator for African students. Built with Flask, Supabase, and Gemini AI, Magic Patterns and CursorAI to identify knowledge gaps and recommend targeted resources.
# 🚀 StudyGapAI
## 🥇 1st Place Winner - WUD AI Hackathon 2025
This is the official frontend for **StudyGapAI**, an AI-powered diagnostic tool that identifies the hidden, foundational knowledge gaps holding Nigerian JAMB students back. Built with React, Vite, and TailwindCSS.
**➡️ Live App:**
tessa-777.github.io
**➡️ Backend Repository:**
github.com
> **⚠️ Important: The `backend-ai-integrated-main` Branch**
> The primary and most up-to-date code for this backend is located in the `backend-ai-integrated-main` branch. Please ensure you clone and work from this specific branch.
---
## Development & Authorship
StudyGapAI was developed entirely by Theresia Saumu as the sole developer for the WUD AI Hackathon 2025 (1st Place Winner).
**Technical Development:** 100% developed by Theresia Saumu
- Full-stack architecture and implementation
- All backend code (Python Flask)
- All frontend code
- Database design and implementation
- AI integration and prompt engineering
- Deployment and DevOps
**Hackathon Collaboration:** During the 1 week hackathon sprint, team members contributed to ideation and strategic direction. All code and technical implementation was authored solely by Theresia Saumu.
**Current Status:** StudyGapAI is now being developed independently by Theresia Saumu.
## ✨ Core Features
- **Guest Mode Quiz:** Users can take a full diagnostic quiz without creating an account. All progress is saved locally and can be migrated after signing up.
- **AI-Powered Diagnostics:** The core of our app. Submits quiz answers *and* student explanations to our Gemini-powered backend to get a deep analysis of strengths and weaknesses.
- **Root Cause Analysis:** Goes beyond simple scores to identify the *foundational* reasons for mistakes (e.g., "weak in Algebra" is the root cause for failing "Calculus" questions).
- **Personalized 6-Week Study Plans:** The AI generates a tailored, week-by-week study plan b …