EduRevise is an AI-powered WAEC/JAMB revision quiz app built with React, Material-UI, and Vite. It helps students prepare for Nigerian standardized exams with offline-first support and intelligent question explanation.
📚 Practice quizzes by subject
🤖 Get AI-generated explanations and more questions
🌐 Works offline as a PWA (Progressive Web App)
- ✅ WAEC/JAMB-style multiple choice quizzes
- 🧠 AI assistance for answer explanation and question generation
- 📊 Local progress tracking and performance insights
- ⚡ Works offline with PWA and IndexedDB support
- 🎯 Built with React, Vite, and Material UI
(Add screenshots here after UI implementation)
| Tech | Description |
|---|---|
| React + Vite | Lightning-fast frontend framework |
| Material-UI | Beautiful, responsive UI components |
| transformers.js (planned) | Run local AI models in-browser |
| PWA | Offline support and installable experience |
| IndexedDB / localStorage | Store quiz data and performance history |
src/
├── assets/ # App icons, logos
├── components/ # Reusable UI components
├── context/ # Global state (quiz/session)
├── data/ # JSON question bank
├── hooks/ # Custom React hooks
├── pages/ # Route-based pages (Home, Quiz, Result)
├── services/ # Local storage, AI service, etc.
└── App.jsx # Main app routing
git clone https://github.com/oladokunlt/edurevise.git
cd edurevisenpm installnpm run devnpm run buildDeployed via Vercel or Firebase Hosting (you choose).
- AI-generated quizzes and answer explanations
- User progress dashboard
- Subject downloads for full offline mode
- In-browser AI via
transformers.jsor local models
PRs welcome! Please fork the repo and submit a pull request. See CONTRIBUTING.md for details.
MIT License © 2025 Lukman Oladokun
Email: lukmanoladokun86@gmail.com
GitHub: @oladokunlt