Skip to content

Rabin-2004/Brain-Storm-Quiz-App-

Repository files navigation

Brain Storm Quiz App 🧠

Welcome to the Quiz App, a fun and interactive platform to test your knowledge across various topics and difficulty levels! Designed with simplicity and functionality in mind, this app offers an engaging way to learn while keeping track of your progress.

Features 🚀

• **Customizable Quizzes**:  
Choose the number of questions and difficulty level (Easy, Medium, Hard) to tailor your quiz experience.

• **Real-Time Feedback**:  
See your accuracy and score at the end of each quiz.

• **Answer Review Mode**:  
Compare your answers with the correct ones to improve and learn.

• **Responsive Design**:  
Optimized for all devices—whether you're on a desktop, tablet, or mobile.

• **User-Friendly Interface**:  
Built with Material UI for a sleek and modern look.

Technologies Used 💻

• **Frontend Framework**: React.js  
• **Styling**: Material UI and CSS  
• **API Integration**: Open Trivia Database (OpenTDB) for fetching quiz questions  
• **State Management**: React Context API  
• **Routing**: React Router DOM

How It Works 🛠️

1. **Start the Quiz**: Select the desired number of questions and difficulty level.
2. **Answer Questions**: Each question provides multiple-choice options.
3. **Submit Answers**: After completing the quiz, view your score, accuracy, and number of correct answers.
4. **Review Answers**: Check which questions you answered correctly and learn from your mistakes.
5. **Return Home**: Reset your preferences and start a new quiz anytime.

Live Demo 🚀

You can access the live app at https://quiz-app-e02ac.web.app/.

Installation and Setup ⚙️

Follow these steps to run the Quiz App locally: 1. Clone the repository:

   git clone https://github.com/yourusername/quiz-app.git
   cd quiz-app
   
2. Install dependencies:
   
   npm install
   
3. Start the development server:
 
   npm start
   
4. Open the app in your browser:
   
   http://localhost:3000

Future Enhancements 🌟

• User authentication for saving quiz history and scores.  
• Add support for custom quizzes (choose your own questions).  
• Include a leaderboard for competitive play.  
• Dark mode for better accessibility.

Contributing 🤝

We welcome contributions! Feel free to fork the repository, make your changes, and submit a pull request.

License 📄

This project is licensed under the MIT License.

Acknowledgments 💬

• Questions sourced from the Open Trivia Database (OpenTDB).  
• Built with ❤️ using React and Material UI.

Start testing your knowledge today with the Quiz App and challenge yourself to learn more! 🚀

Releases

No releases published

Packages

No packages published