https://github.com/danielobara/genius-memory-game
https://github.com/danielobara/genius-memory-game
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/danielobara/genius-memory-game
- Owner: DanielObara
- Created: 2024-12-17T22:36:34.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-02-19T19:58:46.000Z (3 months ago)
- Last Synced: 2025-02-19T20:34:39.501Z (3 months ago)
- Language: JavaScript
- Size: 1.4 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Genius Game
## Overview
Genius Game is a modern implementation of the classic memory game "Simon". The project includes both **solo**, **1vs1** and **cooperative multiplayer** modes, where players test their memory and teamwork to follow sequences of colors that grow progressively harder.
This project used **React**, **TypeScript**, and **Firebase** for real-time sycrhronization and responsive gameplay.
## Features
- đšī¸ **Solo Mode**: Play alone and test your memory as the sequence grows.
- âī¸ **1vs1 Mode**: Test your memory and face your friends.
- đ¤ **Cooperative Mode**: Take turns with another player, working together to complete sequences.
- đž **Real-Time Database**: Firebase Firestore ensures game states are synchronized across players in cooperative mode.
- đ **Sound Effects**: Feedback for correct and incorrect moves.
- đ¨ **User-Friendly Interface**: Clean, responsive design for an enjoyable experience.
- đŧī¸ **Player Profiles**: Displays player names and avatars in multiplayer mode.
## Technologies Used
- **Frontend**: React, TypeScript, CSS
- **Backend**: Firebase Firestore (real-time database)
- **Tools**: Vite, Universal Cookies for user management
- **Assets**: Custom sound effects for feedback
## Setup Instructions
### Prerequisites
- Node.js installed
- Basic knowledge of `npm` commands
### Installation
1. Clone the repository:
```bash
git clone https://github.com/DanielObara/Genius-Memory-Game.git
cd genius-game
```
2. Install dependencies:
```bash
npm install
```
3. Start the development server:
```bash
npm run dev
```
## How to Play
### Solo Mode
1. Start the game.
2. Make login with your google account.
3. Watch the sequence of colors carefully.
4. Repeat the sequence. The game gets harder as the sequence grows longer.
### 1vs1 Mode
1. Enter a room name to create or join a multiplayer session.
2. Players take turns repeating the sequence.
3. Whoever gets the sequence wrong first loses.
### Cooperative Mode
1. Enter a room name to create or join a multiplayer session.
2. Players take turns repeating the sequence.
3. Work together to complete the sequence and advance to the next round.
## Acknowledgments
- Inspired by the classic "Simon" game.
- [@DanielObara](https://github.com/DanielObara) for mentoring during development.
This project was developed by:
- [@ArtHirche](https://github.com/ArtHirche).
- [@Edugiyuu](https://github.com/Edugiyuu).