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

https://github.com/frontend-rob/ring-of-fire

An Angular-based web application of the popular drinking game.
https://github.com/frontend-rob/ring-of-fire

angular scss typescript

Last synced: 3 months ago
JSON representation

An Angular-based web application of the popular drinking game.

Awesome Lists containing this project

README

          

# Ring of Fire

This project was created during the [Developer Akademie](https://developerakademie.com/) bootcamp to practice **Angular** and **TypeScript** concepts. As a learning exercise, some features may not be fully implemented.

NOTE: This project uses images from [FreePik](https://freepik.com/), which are not included in the repository to comply with licensing agreements.


## Features

Here's an overview of the key functionalities:

- **Real-Time Cloud Storage:** Powered by Firebase, ensuring instant data synchronization across all devices.

- **Customizable Players:** Dynamically add player names and avatars before the game begins.

- **Instant Game Sharing:** Generate and share a unique game invitation link for friends to join with just one click.

- **Online Multiplayer:** Play seamlessly with up to 4 players, with real-time updates for everyone.

- **Fully Responsive Design:** Enjoy smooth gameplay on both desktop and mobile devices for maximum flexibility.


## Preview

![mockup-ring-of-fire](https://github.com/user-attachments/assets/0a4737e2-57bb-4969-808e-5af630ec5ed9)

## Run the Application

**1. Version Information:**

This project uses the following versions:
- `Node: 22.13.1`
- `Firebase: 11.3.1`
- `Angular CLI: 19.1.7`

Make sure to use compatible versions to avoid any conflicts.


**2. Clone the Repository:**

Download the source code by clicking the Code button or clone the repository using Git:
```
https://github.com/frontend-rob/ring-of-fire.git
```


**3. Install Dependencies:**

Navigate to the project directory and install the required packages:
```
cd
npm install
```
Note: Replace `` with the actual folder name of your project (e.g., ring-of-fire).


**4. Start Development Server:**

Launch the development server with the following command:
```
ng serve --open
```
The application will open automatically at `http://localhost:4200/`. Any changes you make to the source files will trigger an automatic reload.


**5. Further Help:**

For more information on Angular CLI commands, run `ng help` or vistit the official [Angular CLI Reference](https://angular.dev/cli).


## Contributing
Since this is a learning project, further contributions aren’t expected. However, I’m always open to feedback, suggestions, or creative ideas — if you’d like to share any thoughts, feel free to reach out!


## License

The source code for this project is open-source and distributed under the MIT License and may be used as a reference. Please note that external content from third-party sources is included. For detailed licensing information, refer to the respective websites:

- [FreePik](https://freepik.com/)
- [Phosphor Icons](https://phosphoricons.com/)

You can find further details, including folder structures and links to relevant content sources, in the readme files located within the public folder of this repository.