Skip to content

katasonova/frontend-project-lvl1

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Brain Games

Hexlet tests and linter status:

Actions Status Maintainability

Brain Games is a collection of five command-line educational games built with Node.js.
Each game presents a simple logic or math challenge. The user must give the correct answer three times in a row to win.
This project is part of the Hexlet Frontend Developer program.


📋 Minimum Requirements

  • Node.js ≥ 18.x
  • npm ≥ 9.x
  • Unix-based OS or WSL (Windows Subsystem for Linux)

🛠 Installation

  1. Clone the repository:

    git clone https://github.com/katasonova/frontend-project-lvl1.git
    cd frontend-project-lvl1
  2. Install dependencies:

    npm install
  3. Link the package globally:

    npm link

🚀 How to Play

You can launch any of the games from the terminal:

  • brain-even — determine if a number is even
  • brain-calc — solve arithmetic expressions
  • brain-gcd — find the greatest common divisor
  • brain-progression — find the missing number in a progression
  • brain-prime — determine if a number is prime

Example:

brain-progression

🎮 Gameplay Demonstrations (Asciinema)

Includes both ✅ successful and ❌ failed scenarios

🧠 Brain Even: asciicast

➕ Brain Calc: asciicast

🔢 Brain GCD (Greatest Common Divisor): asciicast

🔍 Brain Progression: asciicast

🧪 Brain Prime: asciicast

🤝 Contributing

Pull requests are welcome. Feel free to open issues or suggest improvements.


Made with ❤️ by @katasonova

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors