yosephdev / quizzy

An Online Quiz App designed to provide users with a wide range of quizzes for knowledge testing and improvement.

Home Page:https://yosephdev.github.io/quizzy/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Online Quiz App

The Online Quiz App is an interactive platform designed to provide users with a wide range of quizzes for knowledge testing and improvement. Leveraging the Open Trivia Database, this app is a school project that offers an engaging user experience with standard web technologies.

Check out how Quizzy looks on different devices

Check out how Quizzy looks like live here

Table of Contents

Back to Top

Project Goals

The Online Quiz App aims to provide an educational and entertaining platform for users to test and improve their knowledge across various subjects. Our primary objectives include:

  • Offer a diverse range of quizzes to cater to different interests and learning needs.
  • Create a user-friendly and engaging quiz experience to enhance user satisfaction.
  • Enable users to track their progress and compare scores, fostering a sense of achievement and motivation.

User Experience (UX)

User Goals

  • Access a wide range of quizzes to test and improve knowledge.
  • Enjoy a user-friendly and engaging quiz experience.
  • Participate in quizzes across various categories.

User Stories

  • As a student, I want to find interesting quizzes to learn and test my knowledge in different subjects so that I can improve my understanding and academic performance.
  • As a teacher, I seek an educational tool where I can engage my students with diverse quiz topics to facilitate interactive learning and knowledge retention.
  • As a quiz enthusiast, I want a platform to challenge myself and compare my scores with others, allowing me to gauge my knowledge and compete in a friendly environment.

Developer's Goals

  • Provide an educational and entertaining quiz platform.
  • Ensure a smooth and responsive user experience.
  • Integrate a variety of quiz categories and difficulty levels.

Design

Fonts

In the design of the Online Quiz App, font choices were carefully considered to ensure readability and a visually appealing interface:

  • Main Text (Arial): Arial (font-family: Arial, sans-serif) was selected for its widespread availability and readability, providing a clean and consistent look for the primary content.

  • Headers (Helvetica): Helvetica (font-family: Helvetica, sans-serif) was chosen to emphasize headers and important text, offering a modern and professional appearance.

Colors

The color palette was meticulously chosen to create a visually appealing and accessible user experience:

  • Primary Color (Blue): #007BFF was selected as the primary color for headers and links to convey professionalism and maintain a cohesive visual identity.

  • Secondary Color (Green): #4CAF50 is used for interactive elements such as buttons to indicate action and progression, enhancing user engagement.

  • Background Color (White): #FFFFFF serves as the primary background color to ensure optimal readability and a clean layout.

  • Text Color (Dark Gray): #333333 provides a softer alternative to black for improved readability and a pleasant reading experience.

  • Accent Color (Light Blue): #B3E0FF is strategically applied to highlight selected categories and quiz options, guiding users through the app with subtle visual cues.

These font and color choices contribute to a cohesive design that enhances usability and user satisfaction.

Structure

A straightforward layout ensuring ease of navigation and optimal performance on all devices.

Wireframes

The initial design phase of the Online Quiz App included wireframes for both mobile and desktop versions to guide the development process:

Mobile Wireframe

View the Mobile Wireframe

Desktop Wireframe

View the Desktop Wireframe

These wireframes provide a visual representation of the app's layout and features, ensuring consistency and usability across different devices.

Back to Top

Features

Current Features

  • Header: Showcasing the app's name and navigational cues. Online Quiz App Header

  • Category Selection: Users can select from various quiz categories, making the quiz experience diverse and customizable. Game Options

  • Dynamic Quiz Interface: The quiz adapts based on the selected category, with a smooth transition between questions. Game Rules

  • Instant Feedback Mechanism: Users receive immediate feedback on their answers, enhancing the interactive experience. Game Feedback

  • Score Tracking: The app accurately tracks and displays the user's score throughout the quiz.

  • Game Results

Features to Be Implemented

  • Leaderboards: To introduce a competitive edge and motivate users to improve.
  • Social Sharing: Enabling users to share scores and challenge friends, thereby increasing the app's reach.
  • User Accounts: Intend to allow users to create accounts to save their progress and scores.

Technologies Used

Languages

  • HTML - For structuring the web app.
  • CSS - For styling the app.
  • JavaScript - For interactive elements and API integration.

Tools

Testing

Testing played a crucial role in ensuring the functionality, usability, and compatibility of the Online Quiz App across various browsers and devices:

Manual Testing

Extensive manual testing was conducted to verify the app's features and functionality:

  • Navigation and Responsiveness: Checked navigation menu, category selection, and responsiveness on different devices and screen sizes.
  • Quiz Functionality: Verified start process, question display mechanics, answer selection, and progression through the quiz.
  • Score Tracking and Results Display: Tested score tracking mechanism and result display accuracy to provide users with accurate feedback.

HTML

  • No errors were returned when passing through the official W3C validator.

CSS

  • No errors were found when passing through the official (Jigsaw) validator.

Lighthouse Report

Accessibility and performance were tested using the Lighthouse tool in Chrome DevTools, and the app scored high in all categories.

Lighthouse Report

Bugs Found and Fixed

  • Solved Bugs:

    • When deployed to GitHub Pages, some links were broken due to path issues. Fixed by updating the file paths.
    • The CSS file link was corrected by removing the leading slash.
  • Unsolved Bugs:

    • There are currently no unsolved bugs.

Reflections and Challenges Encountered

During development, I encountered challenges such as ensuring cross-browser compatibility and maintaining a responsive design. I learned the importance of thorough testing and incremental development.

Deployment

The Online Quiz App is hosted on GitHub Pages. To deploy the app and work on it locally, follow these steps:

GitHub Pages Deployment

  1. Log in to GitHub and locate the GitHub repository for the Online Quiz App.

  2. At the top of the repository (not the main navigation), find the "Settings" button in the menu.

  3. Scroll down the Settings page until you locate the "GitHub Pages" section.

  4. Under "Source," click the dropdown menu that says "None" and select the "Main" branch, then click "Save."

  5. The page will automatically refresh.

  6. Scroll back down to locate the now-published site link in the "GitHub Pages" section. You can access the live site at https://yosephdev.github.io/quizzy/.

Forking the GitHub Repository

By forking the repository, you can create a copy of the original repository on your GitHub account to view and make changes without affecting the original repository. Follow these steps:

  1. Log in to GitHub and locate the GitHub repository for the Online Quiz App.

  2. At the top of the repository (under the main navigation), find the "Fork" button.

  3. Click the "Fork" button to create a copy of the original repository in your GitHub account.

Local Clone

To work on the Online Quiz App locally, you can clone the GitHub repository to your computer using these steps:

  1. Log in to GitHub and locate the GitHub repository for the Online Quiz App.

  2. Under the repository name, click "Clone or download."

  3. Click on the code button and select "clone with HTTPS," "SSH," or "GitHub CLI," then copy the link shown.

  4. Open Git Bash or your preferred terminal.

  5. Change the current working directory to the location where you want the cloned directory to be created.

  6. Type git clone followed by the URL you copied in step 3.

  7. Press Enter, and your local clone will be created.

Now you can deploy the app on GitHub Pages and work on it locally.

Credits

Content

Media

Acknowledgments

  • Simen Daehlin for help with project ideas and tips.
  • Mitko Bachvarov for project guidance and feedback.
  • Thanks to all contributors and testers who have helped improve the app.

Back to Top

About

An Online Quiz App designed to provide users with a wide range of quizzes for knowledge testing and improvement.

https://yosephdev.github.io/quizzy/


Languages

Language:JavaScript 43.5%Language:CSS 21.7%Language:HTML 17.4%Language:Dockerfile 9.2%Language:Python 4.3%Language:Shell 3.8%