Skip to content

adixadymak/quiz-brain

Repository files navigation

Quiz Brain

Quiz Lab - quiz-brain-af339 web app

Quiz Brain is an impressive web application. This project showcases a fully functional quiz game built with React and various relevant technologies. It's designed to be engaging, responsive, and challenging, using the Open Trivia Database (OpentDB) API for quiz questions and answers. Additionally, user scores are tracked, and rewards are given based on specific conditions to enhance the gaming experience.

How to Play

  1. Access the Quiz Brain web application through the provided URL. 👉 https://quiz-brain-af339.web.app/home
  2. Click on the "Start Quiz" button to begin the quiz.
  3. Read each question carefully and select your answer from the multiple-choice options.
  4. Submit your answer by clicking on the "Next" button.
  5. Continue answering questions until you reach the end of the quiz.
  6. After completing the quiz, you'll receive your score and the bonus rewards you earned.

Features

Integrated Quiz API: Utilized the Fetch API to seamlessly retrieve quiz questions and answers from the Open Trivia Database (OpentDB) API, providing users with diverse quiz topics.

Local Storage: Implemented local storage to store user data, including progress, scores, and rewards. This ensures a smooth user experience, even if the application is refreshed or closed.

User Score Tracking: Effectively tracked user scores during the quiz, allowing players to monitor their progress and aim for high scores.

Reward System: Developed a reward system that awards users with bonuses based on specific conditions or achievements during the quiz.

Error Handling: Implemented robust error handling to provide users with meaningful feedback and a smooth experience, even when unexpected issues arise.

Responsive Design: Ensured that the web application is fully responsive across different devices using media queries and CSS modules, making it accessible and enjoyable for users on desktops, tablets, and smartphones.

Quiz Lab - quiz-brain-af339 web app (2)

Technologies Used

React: Built the entire web application using React, leveraging its component-based architecture and state management capabilities.

Context API: Utilized React's Context API to manage the global state, allowing for efficient data sharing and communication between components.

React Router (v5): Incorporated React Router version 5 for seamless navigation and routing, enabling users to move between different quiz sections effortlessly.

Google Firebase: Deployed the React application using Google Firebase hosting, ensuring a reliable and scalable deployment solution.

Planned Features

To further enhance the project and showcase even more advanced skills, the following features are planned for future iterations:

Expanded Quiz Categories: Introduce additional quiz categories to cater to a broader audience and increase the variety of topics.

User Accounts: Implement user account functionality to enable users to register, log in, and track their individual quiz progress and scores.

Leaderboard: Create a leaderboard to display top-performing players, stimulating friendly competition and encouraging users to improve their scores.

Quiz Creator: Allow users to create and share their quizzes, fostering a vibrant community-driven quiz collection.

Installation

As of now, Quiz Brain is a web-based application, so you don't need to install anything to play. Simply access the web app using the provided URL (https://quiz-brain-af339.web.app/home), and you're good to go!

Contributing

We welcome contributions to make Quiz Brain even better. If you have any bug fixes, new features, or improvements in mind, feel free to fork this repository and submit a pull request. We'll review it with gratitude and work together to enhance the project.

Feedback and Support

If you encounter any issues while playing the quiz or have suggestions for improvements, please don't hesitate to open an issue in this repository. We value your feedback and are committed to making Quiz Brain a fantastic experience for all users.

Acknowledgements

We'd like to express our gratitude to the developers and maintainers of the quiz API used in this project. Their efforts have significantly contributed to making Quiz Brain possible.

Learning Outcomes

Through the development of Quiz Brain, I gained valuable experience in the following areas:

API Calls and Data Management: Learned how to integrate external APIs into a React application, fetching data, and managing the retrieved information.

Advanced Problem Solving: Developed the ability to research solutions independently using resources like Stack Overflow, Google Search, and official documentation.

Deployment with Google Firebase: Mastered deploying React applications using Google Firebase hosting, ensuring a smooth and reliable deployment process.

Responsive UI/UX Design: Acquired skills in building responsive web applications using media queries and CSS modules, creating an enjoyable experience across various devices.

React Ecosystem Expertise: Demonstrated proficiency in utilizing the React ecosystem, including React Router and Context API, to build sophisticated applications.

License

This project is free to use for educational purposes.

Let's get quizzing! Challenge yourself and have fun with Quiz Brain!