📝 Short Description An interactive web application that dynamically generates personalized quizzes using Google's Gemini AI. Features include a 10-minute timer, real-time navigation, and comprehensive result analysis.
📖 Overview AI Quiz Master is a modern, responsive quiz application that utilizes artificial intelligence to create customized quizzes on any topic. With just a topic input, the app generates 10 multiple-choice questions of varying difficulty using the Gemini-1.5-Flash model. It provides an engaging learning experience with real-time progress tracking, a countdown timer, and detailed result analytics.
🚀 Technology Stack Frontend
React 18.2.0 – Component-based UI development
JSX – JavaScript syntax extension for React components
Styling
Tailwind CSS 3.3.6 – Utility-first styling
PostCSS 8.4.32 & Autoprefixer 10.4.16 – Enhanced cross-browser support
AI Integration
@google/generative-ai 0.2.1 – Gemini AI for quiz question generation
Gemini-1.5-Flash – Cutting-edge AI model for fast, relevant content generation
Development Tools
Vite 5.0.8 – Fast build tool for instant feedback during development
ESLint 8.55.0 – Code quality and consistency
@vitejs/plugin-react 4.2.1 – React integration with Vite
Deployment
Netlify – Serverless deployment for static React apps
🧠 Key Features Core Functionality
Dynamic Topic Input – Enter any topic for quiz generation
AI-Powered Questions – 10 MCQs per quiz with varied difficulty
Timed Experience – 10-minute countdown with auto-submit
Interactive Navigation – Move between questions freely
Real-Time Answer Feedback – Visual cues for selections
Result Analysis – Detailed score breakdown & question review
User Experience
Responsive Design – Fully functional across devices
Loading Animations – Spinners during AI processing
Progress Tracking – Visual bar & counters
Circular Timer – Color-coded urgency (e.g., green, orange, red)
Suggested Topics – Quick-start with predefined suggestions
Technical Highlights
Modular Component Design – Clean, reusable architecture
Robust State Management – Seamless quiz phase transitions
Error Handling – Graceful fallback for API issues
Auto-submission Logic – Submits quiz when timer hits zero
JSON Validation – Ensures AI returns proper format
🔁 Quiz Flow Topic Selection – Input topic or choose from suggestions
Question Generation – Gemini AI generates personalized questions
Quiz Taking – Answer within the 10-minute window
Results Display – View score, correct answers, and explanations
Restart Option – Take a new quiz with a different topic