Master Math & Reading with AI-Powered Precision
StepUp is a production-ready, adaptive learning platform designed for KS2 students. It transforms the traditional "drill and kill" approach into an engaging, mastery-based experience using LLMs to generate unique, level-appropriate exercises in real-time.
Most learning apps provide static question banks that students eventually memorize. StepUp is different:
- 🧠 Infinite Variety: Every problem is generated on-the-fly, ensuring students never see the same question twice.
- 📈 Mastery-First: We don't just track completion; we track internalized knowledge through streak-based progression.
- ✨ Premium Experience: A high-end "Glassmorphism" UI designed to reduce cognitive load and keep kids focused.
- ⚡ Instant Intelligence: Powered by state-of-the-art LLMs for sub-second generation of complex reading passages and math problems.
The top section of the app provides a real-time snapshot of the student's current session:
- Accuracy: A live percentage of correct vs. total answers. Aim for 80%+!
- Solved: Total count of problems tackled in the current subject.
- Streak: Your most important metric! Shows how many correct answers you've given in a row.
Easily toggle between Mathematics and Reading using the large, interactive glass cards.
Note
Progress (Level and Step) is tracked independently for each subject.
This is where the magic happens. A minimalist, focused area that presents the AI-generated challenge:
- Level & Step: Clearly displayed at the top.
- Problem Area: Large, readable text using the child-friendly Comfortaa font.
- Interactive Feedback: Green/Red sliding overlays provide immediate reinforcement with detailed explanations.
- Smart Hints: Stuck? Click the "Need a hint?" button for a gentle nudge from the AI without giving away the answer.
StepUp follows a rigorous pedagogical structure inspired by the Kumon method, enhanced by AI.
| Level | Mastery Focus |
|---|---|
| Level A | Foundational Concepts & Rapid Recall |
| Level B-D | Intermediate Application & Pattern Recognition |
| Level E-F | Advanced Problem Solving & Critical Thinking |
Each level consists of 10 Steps. To progress from Step 1 to Step 2, a student must demonstrate mastery.
Unlike apps that let you pass with 50% luck, StepUp requires a Streak of 4 correct answers to advance a Step. This ensures the student isn't just guessing but has truly understood the core concept.
# Clone the repository
git clone https://github.com/Yasser03/StepUp.git
# Install dependencies
npm installCreate a .env file in the root directory:
VITE_GROQ_API_KEY=your_gsk_key_herenpm run dev- Frontend: Vite + React 19 + TypeScript
- State Management: Zustand (Atomic, high-performance state)
- AI Brain: LLMs
- Visuals: Lucide React Icons + Custom Glassmorphism CSS System
Dr. Yasser Mustafa
AI & Data Science Specialist | Theoretical Physics PhD
- 🎓 PhD in Theoretical Nuclear Physics
- 💼 10+ years in production AI/ML systems
- 🔬 48+ research publications
- 🏢 Experience: Government (Abu Dhabi), Media (Track24), Recruitment (Reed), Energy (ADNOC)
- 📍 Based in Newcastle Upon Tyne, UK
- 🔗 LinkedIn | GitHub
StepUp — Level up your learning, one step at a time. 🎯