Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎓 AI Quiz Generator

An intelligent quiz generation application powered by Google's Gemini AI that automatically creates interactive quizzes from PDF documents. Built with React.js, Tailwind CSS, and advanced AI capabilities.

✨ Features

🤖 AI-Powered Quiz Generation

  • Automatic Question Generation: Upload any PDF document and let Gemini AI create relevant quiz questions
  • Multi-Language Support: Supports 30+ languages including English, Hindi, Spanish, French, Arabic, Chinese, Japanese, and more
  • Smart Content Analysis: AI analyzes document content to generate meaningful, contextual questions
  • Difficulty Levels: Choose from Easy, Medium, or Hard difficulty levels
  • Customizable: Generate 5-20 questions per quiz

📚 Advanced Quiz Features

  • Interactive Quiz Interface: Clean, intuitive UI with real-time feedback
  • Timer Options:
    • Per-question timer (10-300 seconds)
    • Total quiz time limit (optional)
    • Visual countdown with color-coded warnings
  • Progress Tracking:
    • Live progress bar
    • Question counter
    • Score tracking
  • Answer Review System: Review all answers before final submission
  • Navigation: Move forward/backward between questions freely
  • Visual Feedback: Radio buttons, color-coded answers, and smooth animations

💾 Smart Progress Management

  • Auto-Save: Automatically saves quiz progress to localStorage
  • Resume Feature: Continue incomplete quizzes after browser refresh
  • State Persistence: Maintains answers, timer state, and current position

📄 PDF Export Options

  • Quiz Only PDF: Generate student-friendly quiz sheets
    • Questions with multiple-choice options
    • Answer spaces for writing responses
    • Professional blue theme
    • Print-ready format
  • Quiz with Answers PDF: Generate comprehensive answer keys
    • Highlighted correct answers
    • Detailed explanations
    • Professional green theme
    • Perfect for teachers

🔄 Quiz Management

  • Retake Quiz: Practice with the same questions
  • Generate New Quiz: Create different questions from the same document
  • Load New Document: Start fresh with a new PDF
  • Question Regeneration: Ensures variety in question generation

🎨 Modern UI/UX

  • Responsive Design: Works seamlessly on desktop, tablet, and mobile
  • Gradient Themes: Beautiful blue-to-purple gradients
  • Smooth Animations: Professional transitions and effects
  • Accessibility: Keyboard navigation and screen reader support
  • Color-Coded Feedback: Green for correct, red for incorrect answers

🎯 How to Use

1. Upload a PDF Document

  • Click on the upload area or drag & drop a PDF file
  • Supports educational materials, textbooks, research papers, etc.

2. Configure Quiz Settings

  • Number of Questions: Slide to select 5-20 questions
  • Difficulty Level: Choose Easy, Medium, or Hard
  • Language: Auto-detect or force a specific language

3. Generate Quiz

  • Click "Generate Quiz with AI"
  • Wait 10-30 seconds for AI processing
  • Quiz automatically loads when ready

4. Set Timer (Optional)

  • Configure total time limit for the entire quiz
  • Set time per question
  • Or skip timers for unlimited time

5. Take the Quiz

  • Read each question carefully
  • Select your answer by clicking an option
  • Use Previous/Next buttons to navigate
  • Click "Review All Answers" to see progress

6. Review and Submit

  • Check all your answers
  • Edit any answer by clicking "Edit"
  • Submit when ready

7. View Results

  • See your score and percentage
  • Review correct/incorrect answers
  • Read explanations for each question

8. Export Results

  • Download Quiz Only: For practice or classroom use
  • Download Quiz + Answers: For answer keys

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages