Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bingo: Speed Edition ⚡

![App Screenshot/Logo] (image) (image) (image) (image) (image)


📝 Game Description

Bingo: Speed Edition is a high-stakes, fast-paced twist on the classic game of Bingo. While traditional Bingo is a game of patience, this version tests your reflexes and focus.

Each player is given a randomized 5x5 board. As numbers are drawn from a pool of 1-75, a speed timer begins. You must find and mark the number on your board before the timer hits zero—otherwise, the chance is lost! The first player to complete a straight line (horizontal, vertical, or diagonal) and click "BINGO!" wins.

💡 Background & Motivation

I chose to build Bingo because it is a globally recognized game with simple rules, which allowed me to focus my technical efforts on state management and real-time UI updates.

By adding the "Speed Edition" mechanics, I wanted to challenge the user's "mental processing speed" under pressure. From a developer's perspective, this project was a great way to practice handling complex game logic, such as preventing illegal moves when a timer expires and managing the interaction between two players on a single interface.


🚀 Getting Started

🔗 Important Links

🕹️ How to Play

  1. Choose Difficulty: Select Easy (10s), Medium (5s), or Hard (3s) to set the turn timer.
  2. Draw a Number: Click the "Generate Number" button to draw a ball.
  3. Be Fast: You can only mark your board while the timer is ticking. If the timer hits 0, the board "locks" until the next number is drawn.
  4. Call Bingo: Once you have 5 in a row, hit the "BINGO!" button.
    • Warning: If you call Bingo incorrectly, you lose the game immediately!

🛠️ Technologies Used

  • HTML5: For the semantic structure of the game boards and instructions.
  • CSS3: For the responsive grid layout, "Sage Green" professional theme, and shake/glow animations.
  • JavaScript (ES6): The "Engine" of the game, handling the Fisher-Yates shuffle, countdown intervals, and win-condition algorithms.

📜 Attributions

  • Fonts: Google Fonts for clean typography.
  • Logic Inspiration: Based on classic Bingo rules with custom speed-mechanics added.

🔮 Next Steps (Stretch Goals)

  • Hidden Logic: A feature to hide the player board if it is not the turn for faireness on same interface (Phase 1).
  • Local Storage Game Log: A feature to save and view the history of previous winners.
  • Multiplayer Mode: Implementing WebSockets to allow two players to play from different devices.
  • Theming: Allow users to toggle between "Dark Mode" and "Classic Casino" themes.
  • Sound Effects: Add audio cues for drawing numbers and winning celebrations.

Built with ❤️ by Hasan Khesro

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages