QuizMaster - Interactive Quiz Application

A modern, responsive quiz application built with React.js featuring dark/light theme, multiple categories, and performance analytics.

🚀 Features

• Multiple Quiz Categories: General Knowledge, Science, History, Geography, Sports, Entertainment, Technology, Literature
• Three Difficulty Levels: Easy, Medium, Hard
• Dark/Light Theme Toggle: Seamless theme switching
• Timed Questions: 15-second timer per question
• Performance Analytics: Track answer times and accuracy
• Responsive Design: Works on all devices
• Score Tracking: Persistent leaderboard with localStorage
• Glassmorphism UI: Modern, elegant interface

🛠️ Technologies Used

• React.js 18
• React Router DOM
• CSS3 (Glassmorphism, CSS Variables)
• LocalStorage for data persistence
• Modern ES6+ JavaScript

📦 Installation

1. Clone the repository:

   git clone https://github.com/yourusername/KTJ-ASS3.git
   cd KTJ-ASS3

2. Install dependencies:

   npm install

3. Start the development server:

   npm start

4. Open http://localhost:3000 to view it in the browser.

🎮 How to Use

1. Start Quiz: Enter your name and select category/difficulty
2. Answer Questions: Click on options within the 15-second timer
3. View Results: See detailed performance analytics
4. Check Leaderboard: Compare scores with other players
5. Toggle Theme: Use the theme button in navigation

📊 Quiz Categories

• General Knowledge: Basic facts and trivia
• Science & Nature: Physics, chemistry, biology
• History: World history and events
• Geography: Countries, capitals, landmarks
• Sports: Various sports and athletes
• Entertainment: Movies, music, celebrities
• Technology: Programming, computers, tech
• Literature: Books, authors, poetry

🏗️ Build for Production

npm run build

This creates an optimized production build in the build folder.

🎨 Theme Features

• Light Mode: Clean, modern interface with soft colors
• Dark Mode: Deep navy and purple theme for night use
• Smooth Transitions: Animated theme switching
• Consistent Branding: Maintains visual identity across themes

📱 Responsive Design

• Mobile First: Optimized for mobile devices
• Tablet Support: Perfect tablet experience
• Desktop Enhanced: Full-featured desktop interface

🏆 Scoring System

• Correct Answer: +1 point
• Time Bonus: Faster answers get recognition
• Performance Tracking: Detailed analytics per quiz
• Persistent Storage: Scores saved locally

👥 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🎓 Academic Project

Built for the Kshitij Web Development Workshop - Assignment 3

🔗 Live Demo

View Live Demo

---

"The only way to learn to program is by writing programs." - Dennis Ritchie