Skip to content

skoulasp/numbers-game

Repository files navigation

Simple Math Practice Game

Welcome to the Simple Math Practice Game – a tool designed to help you enhance your mental math skills through engaging calculations. This web application provides a continuous practice experience, sharpening your mathematical prowess with each calculation.

Key Features

  • Quiz Style Gameplay: Each round lasts 30 seconds, during which the player must solve a mathematical operation. There are 4 possible answers to choose from.

  • Infinite Rounds: There's no set limit on the number of rounds; the game continues indefinitely.

  • Consecutive Correct Rounds: Your progress is measured by the streak of correct answers you achieve without a single mistake.

  • Display Stats: While playing, the game displays important stats such as the number of wins, losses, and total rounds played.

  • Local Storage Tracking: Your best performances are recognized and tracked using the local storage API.

  • Pause Feature: Pause the game indefinitely with the "PAUSE" button, allowing you to take a break. However, to prevent abuse, new numbers are generated upon resuming, and the pause button is locked for 2 minutes after each use.

  • Menu Options: The initial menu offers two buttons: "INFO" to display detailed game information and "START" to begin the game.

  • Reset Option: End the game and return to the initial menu with the "RESET" button.

  • Ultimate Bonus: Achieving a streak of over 20 consecutive correct answers unlocks the ultimate bonus, rewarding the player with a special decorative color scheme in the main menu view.

About

Welcome to the Simple Math Practice Game – a tool designed to help you enhance your mental math skills through engaging calculations. This isn‘t a traditional game with levels or set challenges; rather, it offers a continuous practice experience to sharpen your mathematical prowess. Your progress isn‘t measured by victories or milestones, but by the streak of correct answers you achieve without a single mistake. This achievement is tracked using the local storage API, ensuring your best performances are recognized.

Embark on your math practice journey, sharpen your mind with every calculation, and aim to surpass your best performance. Enjoy the challenge and improve your skills!

This web application was crafted using the React library, layered on top of HTML, CSS (leveraging Sass), and JavaScript, all in the year 2023. Sharpen your mind with every calculation and aim to surpass your best performance. Enjoy your math practice journey!

Technologies Used

  • React: JavaScript library for building user interfaces.
  • Sass: CSS preprocessor for styling.
  • JavaScript: Programming language for adding interactivity and functionality.
  • Vite: Next-generation frontend tooling.

Demo

You can play the game live here.

Screenshots

Screenshot 1Main menu

Screenshot 2Basic gameplay view

Screenshot 3Gameplay during pause state

Screenshot 4Gameplay after unpausing

Screenshot 5Main menu after achieving the "Ultimate Bonus"

Screenshot 6Main menu after achieving the "Ultimate Bonus" with hover effect

Installation and Usage

To install and run the project locally:

  1. Clone the repository to your local machine:

    git clone https://github.com/yourusername/numbers-game.git
  2. Navigate to the project directory:

    cd numbers-game
  3. Install dependencies using npm:

    npm install
  4. Start the development server:

    npm run dev
  5. Open the project in your web browser at http://localhost:3000.

Credits

This project was created by [Your Name]. For any inquiries or feedback, feel free to reach out!

License

This project is licensed under the MIT License.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors