📝 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

Built With

Share this project:

Updates