AI-powered quiz application for government exam preparation - Master SSC, UPSC, Bank exams, and more with personalized practice sessions!
Built with React, powered by Google's Gemini AI, and featuring a stunning glassmorphic UI.
- 🤖 AI-Powered Questions - Unlimited practice questions generated by Google Gemini AI
- 📚 Multiple Categories - Current Affairs, Geography, History, Indian Defence, Politics
- 🎯 Difficulty Levels - Easy, Medium, Hard difficulty options
- ⏱️ Timed Quizzes - Real exam-like timed practice (30 seconds per question)
- 📊 Detailed Analytics - Comprehensive score reports with explanations
- 🎨 Glassmorphic UI - Modern, beautiful design with smooth animations
- 📱 Responsive Design - Works seamlessly on desktop, tablet, and mobile
- 🌐 Open Source - Free forever, built for the community
- Node.js (v14 or higher)
- npm or yarn
- Google Gemini API key
-
Select Your Preferences
- Choose a category (Current Affairs, Geography, etc.)
- Pick difficulty level (Easy, Medium, Hard)
- Select number of questions (5, 10, 15, or 20)
-
Take the Quiz
- Answer questions within the time limit
- Timer runs based on question count
- Select your answer by clicking on options
-
Review Results
- View your score and percentage
- See correct/incorrect answers
- Read detailed explanations for each question
We love contributions! Here's how you can help:
- 🐞 Fix bugs and issues
- ✨ Add new features (more categories, difficulty algorithms, etc.)
- 🎨 Improve UI/UX design
- 💡 Suggest improvements
- Check existing Issues or create a new one
- Fork the repository
- Create a new branch:
git checkout -b feature/your-feature-name - Make your changes
- Test thoroughly
- Commit with clear messages:
git commit -m "Add: feature description" - Push to your fork:
git push origin feature/your-feature-name - Open a Pull Request
Please read our CONTRIBUTING.md for detailed guidelines.
This repository participates in Hacktoberfest!
- Look for issues labeled
hacktoberfest,good-first-issue, orhelp-wanted - Make meaningful contributions (spam PRs will be marked as
invalid) - Follow our contribution guidelines
- Be respectful and collaborative
Note: Quality over quantity! We value thoughtful contributions.
- Frontend: React + Vite
- Styling: Custom CSS with Glassmorphism
- AI: Google Gemini 1.5 Flash
- Build Tool: Vite
- Package Manager: npm
- User authentication and profiles
- Progress tracking dashboard
- Leaderboard system
- More exam categories (GATE, CAT, etc.)
- PDF export of quiz results
- Dark/Light theme toggle
- Previous year papers integration
Check the Issues page for current bugs and feature requests.
- Google Gemini AI for powering the question generation
- The open-source community for inspiration
- All our amazing contributors
- Star this repository if you find it helpful
- Report bugs by opening an Issue
- For questions, start a Discussion
Created by @sb-decoder
Happy Learning! Happy Contributing!
Made with ❤️ for students and open-source