Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/silent-watcher/rock-paper-scissors
an interactive web application that brings the classic hand game "Rock-Paper-Scissors" to the digital world
https://github.com/silent-watcher/rock-paper-scissors
alexjs eslint game-development htmlcssjs husky javascript rock-paper-scissors web webproject
Last synced: about 1 month ago
JSON representation
an interactive web application that brings the classic hand game "Rock-Paper-Scissors" to the digital world
- Host: GitHub
- URL: https://github.com/silent-watcher/rock-paper-scissors
- Owner: Silent-Watcher
- License: mit
- Created: 2022-08-04T11:34:32.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-05-07T11:35:39.000Z (8 months ago)
- Last Synced: 2024-12-03T00:07:06.144Z (about 1 month ago)
- Topics: alexjs, eslint, game-development, htmlcssjs, husky, javascript, rock-paper-scissors, web, webproject
- Language: JavaScript
- Homepage: https://silent-watcher.github.io/rock-paper-scissors/
- Size: 675 KB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# rock-paper-scissors 🕹
This GitHub project is a web-based implementation of the classic Rock-Paper-Scissors game, featuring an interactive user interface, a computer opponent with randomized moves, and score tracking for an enjoyable gaming experience.
[](https://github.com/Silent-Watcher/cli-word-guessing-game)
## Table of Contents
- [demo](https://github.com/Silent-Watcher/rock-paper-scissors#demo)
- [Features](https://github.com/Silent-Watcher/rock-paper-scissors#features)
- [Prerequisites](https://github.com/Silent-Watcher/rock-paper-scissors#Prerequisites)
- [Installation](https://github.com/Silent-Watcher/rock-paper-scissors#Installation)
- [usage](https://github.com/Silent-Watcher/rock-paper-scissors#usage)
- [Contributing](https://github.com/Silent-Watcher/rock-paper-scissors#Contributing)
- [Contact](https://github.com/Silent-Watcher/rock-paper-scissors#Contact)
- [License](https://github.com/Silent-Watcher/rock-paper-scissors#License)
## Demo
Experience the power of the rock-paper-scissors by visiting the demo page.
You can try out the game by following this [demo link.](https://silent-watcher.github.io/rock-paper-scissors/)
[](https://stackblitz.com/github/Silent-Watcher/rock-paper-scissors)
## Features
- **Interactive Gameplay**: Users can play the classic Rock-Paper-Scissors game directly through the web interface.
- **Computer Opponent**: The project includes an AI-based computer opponent that randomly selects its move, providing an opponent for the player to compete against.
- **Responsive Design**: The web application is designed to work seamlessly on various devices and screen sizes, ensuring a responsive and user-friendly experience.
- **Score Tracking**: The project keeps track of the user's and computer's scores throughout the game, providing a running tally of wins, losses, and ties.
- **Game Result Display**: After each round, the application displays the result of the round, indicating whether the player won, lost, or tied with the computer.
- **Game Reset**: Users have the option to reset the game and start a new round or session with a single click.
- **Randomized Computer Moves**: The computer's move (rock, paper, or scissors) is randomized to create an element of unpredictability and challenge for the player.
- **Winning Condition**: The project implements the traditional Rock-Paper-Scissors ruleset to determine the winner of each round, based on the chosen moves.
- **User-Friendly Interface**: The web interface is designed with a clean and intuitive layout, making it easy for users to understand and play the game.
- **Open Source**: The project is hosted on GitHub and is open source, allowing developers to explore the codebase, contribute to the project, or use it as a learning resource.
## Prerequisites
In order to run this project, you will need to have the following installed on your computer:
- nodejs
- yarn | npm | pnpm
## Installation
To install the application, follow these steps:
1. Clone the repository to your local machine:
```bash
git clone https://github.com/Silent-Watcher/rock-paper-scissors
```
2. Navigate to the project directory in your terminal.
```bash
cd rock-paper-scissors
```
3. Run `npm install` to install the necessary packages.
```bash
npm install
```
4. Run `npm run prepare` to install husky.
```bash
npm run prepare
```
## usage
To start the application, run `npm run dev` . This will start the application on http://localhost:5173.
```bash
npm run dev
```
## Technologies
## Contributing 🤝🏾
Contributions to this project are welcome.
If you encounter any issues or have suggestions for improvement, please open an issue on the GitHub repository.
Before contributing, please review the contribution guidelines.
## Contact
For additional information or inquiries, you can reach out to the project maintainer:
- Name: Silent-Watcher
- Email: [email protected]
Feel free to contact the maintainer for any questions or feedback regarding the project.
## License 🔐
[MIT](https://choosealicense.com/licenses/mit/)
This project is licensed under the MIT License. You are free to modify, distribute, and use the code for personal and commercial purposes. See the LICENSE file for details.
## Sponsor ❤
If you like this project, please give it a star ⭐ and/or consider buying me a coffee(s). Every donation is appreciated.
