bdelanghe / hookie

A word deconstruction game developed with boardgame.io and React, providing a strategic Scrabble Hooks variant 🎲🔤

Hookie: Unravel the Words! 🎲🔤

Welcome to Hookie! This is a fascinating twist on Scrabble Hooks with a touch of reverse charm. This project leverages the robust boardgame.io framework with the power of React, Redux, and WebSockets to create an engaging and strategic gameplay. 🌐💻🚀

Hookie: The Reverse Scrabble Hooks 🔄

Imagine a game of Scrabble where you peel off layers of words rather than constructing them. This is Hookie! The game begins with a word sprouting from the center star. As players, you carefully deconstruct words, unraveling them until you're left with a core. Once there are no subwords left to discover, it's time to place a new word. This cycle repeats until you've exhausted all the letters in the Scrabble bag. 🎁⭐🔄👜

Development 🔧

To get started with development, you'll need to set up your local environment. Please ensure you have Node.js and npm installed before proceeding.

1. Clone the Repository: Use git clone to get a copy of the repository on your local machine.

2. Install Dependencies: Navigate to the project directory and run npm install to install all necessary dependencies.

3. Start the Development Server: Run npm start to start the local development server.

4. Testing: Ensure all new additions are covered with tests. Run npm test to execute the test suite.

Feel free to explore the codebase and experiment with features or improvements!

Technology Stack 💻

Hookie blends modern web technologies to create a compelling gaming experience:

• boardgame.io: A game development framework perfect for building turn-based games.
• React: A JavaScript library for crafting interactive UIs.
• Redux: A reliable state container for JavaScript applications.
• WebSockets: Allowing real-time, bidirectional communication between the game server and clients.
• Heroku: A platform-as-a-service (PaaS) used to deploy, run, and manage the application.

Deployment 🚀

Hookie is hosted on Heroku, which offers a robust, scalable cloud platform that easily accommodates our game's growth.

How to Contribute 🤝

Contributions of all forms are welcome - from bug fixes to documentation improvements and new features. To contribute:

1. Fork the Repository: Create a copy of the Hookie repository on your GitHub account.
2. Clone the Forked Repository: Get a local copy of the fork on your machine.
3. Create a New Branch: Make your changes in this branch.
4. Implement Changes: Implement your bug fixes, enhancements, or new features.
5. Commit and Push Changes: Ensure your commit messages are clear and meaningful.
6. Create a Pull Request: We'll review your contributions and possibly merge them into the main codebase.

Final Words 🎀

Hookie thrives on its community and represents more than just a game. It's a dynamic, evolving project with an array of opportunities to learn, contribute, and have fun. So prepare your strategic mind, and let's dive into the exciting world of unraveling words! 🎉👏📖

Ready to get hooked on Hookie? 🌟🎲🔤