CHECKMATH is a fun and challenging game where players compare mathematical expressions and provide the correct answer within a limited time. The project is designed to enhance logical thinking, quick calculation skills, and focus through randomly generated math puzzles.
-
Randomized Questions:
- The system automatically generates questions comparing two mathematical expressions.
- Expressions can include various operations such as
+
,-
,*
,/
, and the number of components in the expressions varies depending on difficulty.
-
Multiple Difficulty Levels:
- Easy: Simple expressions with small numbers.
- Normal: More complex expressions with larger numbers and multiple operations.
- Hard: Long expressions with numerous components and challenging operations.
-
Answer Validation:
- Players compare two expressions by selecting one of the symbols:
>
,<
, or=
. - The system validates the answer and provides immediate feedback.
- Players compare two expressions by selecting one of the symbols:
-
Cheating Detection:
- Integrated cheating detection mechanism ensures fair gameplay by monitoring suspicious behavior.
-
Result Tracking:
- Keeps a history of questions and user performance.
- Helps players evaluate their progress and accuracy over time.
- Node.js (>= 18.x)
- A package manager: pnpm or yarn
-
Clone the repository from GitHub:
git clone https://github.com/check-math/game.git cd game
-
Install dependencies:
pnpm install
or if using
yarn
:yarn install
-
Run the application:
pnpm dev
or with
yarn
:yarn dev
-
Access the game: Open your browser and navigate to:
http://localhost:3000
.
- At the start of the game, a random question is displayed, asking you to compare two mathematical expressions.
- Players must select the correct symbol (
>
,<
, or=
) within the given time. - If the answer is correct, the next question will be displayed. If incorrect, feedback will be provided, and points may be deducted.
CHECKMATH/
├── src/
│ ├── components/ # Core UI components
│ ├── composables/ # Hooks (generateQuiz, checkAnswer, etc.)
│ ├── assets/ # Resources such as images, icons
│ ├── styles/ # CSS and styling files
│ ├── router/ # Routing
│ ├── types/ # Interface
│ ├── views/ # Pages
│ ├── stores/ # State management
│ ├── constant/ # Constants
│ ├── App.vue # Vue main file
│ └── main.ts # JS main file
├── public/ # Static files served by the application
├── .env # Enviroment config
├── vite.config.ts # Vite config
├── tailwind.config.ts # TailwindCSS config
├── index.html # Index public file
├── package.json # Project configuration and dependencies
└── README.md # Project documentation (you’re reading this!)
If you'd like to contribute to this project:
- Fork the repository on GitHub.
- Create a new feature branch:
git checkout -b feature/new-feature
- Commit and push your changes:
git commit -m "Add new feature" git push origin feature/new-feature
- Open a Pull Request (PR) on GitHub.
This project is licensed under the MIT License. You are free to use, modify, and distribute it under the terms of this license.
- GitHub Repository: Check Math Game
- Developer Contact: For any questions or suggestions, feel free to open an Issue.
Have fun playing the game! 🎉