Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ramazancetinkaya/hangman-game

A modern and responsive Hangman game built using HTML5, CSS, and JavaScript.
https://github.com/ramazancetinkaya/hangman-game

css hangman hangman-game hangman-javascript html5 javascript responsive

Last synced: 1 day ago
JSON representation

A modern and responsive Hangman game built using HTML5, CSS, and JavaScript.

Awesome Lists containing this project

README

        

# Hangman Game

![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge&logo=open-source-initiative&logoColor=white)
[![Stars](https://img.shields.io/github/stars/ramazancetinkaya/hangman-game?style=for-the-badge&color=FAD02E&logo=github)](https://github.com/ramazancetinkaya/hangman-game/stargazers)
[![Issues](https://img.shields.io/github/issues/ramazancetinkaya/hangman-game?style=for-the-badge&color=E4405F&logo=github)](https://github.com/ramazancetinkaya/hangman-game/issues)
[![Forks](https://img.shields.io/github/forks/ramazancetinkaya/hangman-game?style=for-the-badge&color=00C853&logo=github)](https://github.com/ramazancetinkaya/hangman-game/network/members)

Hangman Game is an engaging and interactive word-guessing game designed for the web. Built using HTML5, CSS, and JavaScript, it combines a sleek, user-friendly interface with responsive design to provide a seamless gaming experience across devices. Explore diverse word categories and test your vocabulary skills in a fun and challenging way.

## Live Demo 🌐

**Play the game instantly via GitHub Pages!**

[![Live Demo](https://img.shields.io/badge/Live%20Demo-Play%20Now-brightgreen?style=for-the-badge&logo=github)](https://ramazancetinkaya.github.io/hangman-game)

---

## Features

- **Dynamic Word Categories:** Choose from various categories such as Technology, Sports, Movies, and more.
- **Difficulty Levels:** Easy, Medium, and Hard difficulty settings for all word categories.
- **Responsive Design:** Fully optimized for desktops, tablets, and mobile devices.
- **Interactive UI:** Smooth animations and clear visuals for an engaging user experience.
- **Error Handling:** Proper feedback for missing or corrupted data.

## Technologies Used

- **HTML5** for structure
- **CSS3** for styling (responsive design and animations)
- **JavaScript** for interactivity

## Installation

To get a local copy up and running, follow these simple steps:

### Prerequisites

- A modern web browser (Google Chrome, Firefox, Edge, etc.)

### Clone the Repository

1. Clone the repository:
```bash
git clone https://github.com/ramazancetinkaya/hangman-game.git
```

2. Navigate to the project folder:
```bash
cd hangman-game
```

3. Open `index.html` in your browser:
```
Open index.html in any modern browser.
```

## Usage

1. Select a category and difficulty level.
2. Guess letters to reveal the hidden word.
3. Avoid making more than 6 incorrect guesses, or the game ends.
4. Enjoy the challenge and try different categories!

## File Structure

```
hangman-game/
β”œβ”€β”€ index.html # Main HTML file
β”œβ”€β”€ style.css # CSS file for styling
β”œβ”€β”€ script.js # JavaScript for game logic
β”œβ”€β”€ words.json # Word data (categories and difficulties)
└── README.md # Project documentation
```

## Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue for any enhancements or bug fixes.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.

## Acknowledgments

- Inspired by the classic Hangman game.
- Built with passion and love for coding.
- Designed and developed with πŸ’– by [Ramazan Γ‡etinkaya](https://github.com/ramazancetinkaya).