Skip to content

Latest commit

 

History

History
132 lines (94 loc) · 3.32 KB

README.md

File metadata and controls

132 lines (94 loc) · 3.32 KB

https://hangedassembly.netlify.app/

Assembly : Endgame

Welcome to Assembly: Endgame, a twist on the classic Hangman game where the stakes are higher! Instead of simply guessing letters, every incorrect guess results in the tragic demise of a beloved programming language. Will you save them all, or will you bid farewell to your favorites? 👾💻

🚀 Features

  • Dynamic Gameplay: Each incorrect guess "kills" a programming language in real-time.
  • React-Powered: Built with React for a smooth and interactive user experience.
  • Custom Word List: Challenge yourself with a selection of random words.
  • Language Survival Tracker: Keep track of the programming languages you've saved and the ones you've lost.

🛠️ Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/hangman-programming-languages.git

  2. Navigate to the project directory:

    cd hangman-programming-languages

  3. Install dependencies:

    npm install

  4. Start the development server:

    npm start

  5. Open the game in your browser:

    http://localhost:3000

🎮 How to Play

  1. Start the game by clicking on any keyboard letter.
  2. Guess the word by selecting letters.
  3. For every incorrect guess, a programming language "dies" (it becomes ☠️).
  4. The game ends when:
    • You guess the word correctly (Congratulations! 🎉).
    • All programming languages have "died" (Game Over 😢).

🔧 Technologies Used

  • React: For building the UI and managing state.
  • CSS Modules: For styling.

📂 Project Structure

.
├── App.jsx             // Main app component
├── hint.md             // Optional hints for developers
├── index.css           // Global styles
├── index.html          // Entry HTML file
├── index.jsx           // React entry point
├── languages.js        // Language data and logos
├── package.json        // Project metadata and dependencies
├── README.md           // Project documentation
├── utils.js            // Helper functions
├── vite.config.js      // Configuration for Vite
└── words.js            // Word list for the game

📜 Roadmap

  • Add a leaderboard to track the best scores.
  • Implement a multiplayer mode to compete with friends.
  • Expand the word list with categories (e.g., frontend, backend, frameworks).
  • Add more visual effects for saved languages.

🙏 Acknowledgments

  • Inspired by the classic Hangman game.
  • Special thanks to the coding community for keeping programming languages alive!

🧙‍♂️ Contribution

Contributions are welcome! If you have ideas for new features or improvements, feel free to fork the repository and create a pull request.

  1. Fork the repository.
  2. Create a new branch for your feature: 
    git checkout -b feature-name
  3. Commit your changes: 
    git commit -m "Add your feature description here"
  4. Push the branch: 
    git push origin feature-name
  5. Open a pull request.

📧 Contact

For questions or feedback, feel free to reach out:

]- GitHub: [github.com/qcklex]

Enjoy saving (or losing 😅) programming languages! Have fun playing! 🧑‍💻

Happy Coding!