Skip to content

๐Ÿงฎ An interactive math quiz game built with vanilla JavaScript and Tailwind CSS. Features random arithmetic operations, progressive scoring, and local progress saving. Perfect for students and math practice!

License

Notifications You must be signed in to change notification settings

VinayNoogler000/Math-Quiz-Game

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

22 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿงฎ Math Quiz Game

License: MIT GitHub issues GitHub stars HTML5 TailwindCSS JavaScript

An engaging web-based math quiz game built with vanilla JavaScript that challenges players with random arithmetic operations. Features progressive scoring, local progress saving, and responsive design for an optimal learning experience.

โœจ Features

  • ๐ŸŽฒ Random question generation for four basic operations (addition, subtraction, multiplication, division)
  • ๐Ÿ“ˆ Progressive scoring system (+3 for correct answers, -1 for incorrect)
  • ๐Ÿ’พ Local storage integration for saving progress
  • ๐ŸŽฏ Three attempts per question before showing the correct answer
  • ๐Ÿ“ฑ Fully responsive design across all devices
  • ๐Ÿ”” Interactive toast notifications for user feedback
  • ๐ŸŽจ Modern UI with smooth animations and transitions

๐Ÿš€ Live Demo

Experience the game live: Math Quiz Game

๐Ÿ“ธ Screenshots

Math Quiz Game Banner

๐Ÿ› ๏ธ Technologies Used

  • HTML5
  • CSS3 with Tailwind CSS
  • Vanilla JavaScript
  • Toastify JS Library
  • Local Storage API

๐ŸŒŸ Key Learnings

During the development of this project, I gained valuable experience in:

  1. Generating random numbers within specific ranges
  2. Understanding CSS Sticky Position property
  3. Working with the animationend event
  4. Browser reflow optimization techniques
  5. Local Storage API implementation
  6. Toast notifications using Toastify JS
  7. Error handling and user feedback
  8. Tailwind CSS @layer directives

๐Ÿ’ก How to Play

  1. Choose to save your score locally, through the browser prompt
  2. Start the game by answering the initial question
  3. Each correct answer adds 3 points to your score
  4. Each incorrect answer deducts 1 point
  5. You get 3 attempts per question before the correct answer is shown
  6. Continue your progress across sessions, using the local storage feature

๐ŸŽฎ Game Controls

  • Type your answer in the input field
  • Press Enter or click Submit to check your answer
  • Use the local storage prompt to manage your progress:
    • Type 'Yes' to save progress
    • Type 'No' to play without saving
    • Type 'Delete' to remove saved progress
    • Click 'Cancel' if progress is already saved

๐Ÿ“ฅ Installation

  1. Clone the repository:
git clone https://github.com/VinayNoogler000/Math-Quiz-Game.git
  1. Navigate to the project directory:
cd Math-Quiz-Game
  1. Install tailwindcss via npm:
  npm install -D tailwindcss
  1. Start the Tailwind's build process to Build the CSS file:
  npx tailwindcss -i src/style.css -o dist/output.css --watch
  1. Open index.html in your preferred browser & see the project working live.

๐Ÿค Contributing

Contributions are welcome! Here's how you can help:

  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

๐Ÿ› Bug Reporting

Found a bug? Please open an issue with a clear description and steps to reproduce. Your input helps make this project better for everyone!

๐Ÿ“ Todo

  • Add difficulty levels
  • Implement a timer feature
  • Add sound effects
  • Create a leaderboard
  • Add more mathematical operations
  • Implement a practice mode

๐Ÿ™ Acknowledgments

๐Ÿ”‘ License

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

๐Ÿ“ž Contact Developer & Owner

Vinay Tambey

Project Link: GitHub Repo
Let's connect and collaborate! I'm always open to new opportunities in frontend web development.

๐Ÿ“Š Project Status

This project is, currently, not in development by the Owner, but we're always looking to add new features and improvements!

๐Ÿ’ผ Support

Give a โญ๏ธ if this project helped you!


Made with โค๏ธ by Vinay Tambey

About

๐Ÿงฎ An interactive math quiz game built with vanilla JavaScript and Tailwind CSS. Features random arithmetic operations, progressive scoring, and local progress saving. Perfect for students and math practice!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published