https://github.com/siddh-coder/memory-game
https://github.com/siddh-coder/memory-game
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/siddh-coder/memory-game
- Owner: siddh-coder
- Created: 2024-12-17T11:37:32.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-17T13:05:59.000Z (over 1 year ago)
- Last Synced: 2025-03-25T05:36:00.886Z (over 1 year ago)
- Language: CSS
- Homepage: https://memory-game-by-sid.vercel.app
- Size: 83 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Memory Game
This is a fun and interactive Memory Game built using **Flask** as the backend and **JavaScript** for the frontend. Players can select a grid size (4x4 or 6x6) and test their memory skills by matching cards. The game includes animations, a moves counter, a timer, and session history for best scores.
---
## Features
- **Grid Selection**: Choose between 4x4 and 6x6 grids.
- **Moves Counter**: Tracks the number of moves made by the player.
- **Timer**: Tracks the time taken to solve the game.
- **Session History**:
- Stores the best score and the shortest time for the current session.
- **Smooth Animations**: Engaging animations for flipping cards and transitioning.
- **Dynamic Background**: Gradient background animation for a lively look.
---
## Project Structure
```
/project
├── app.py # Main Flask application
├── requirements.txt # Python dependencies
├── static/ # Static assets (CSS, JS, images)
│ ├── styles.css # Styling for the game
│ ├── script.js # Frontend game logic
│ ├── images/ # Card images
├── templates/ # HTML templates
│ ├── index.html # Home page
│ ├── game.html # Game page
└── history.txt # Session history file (created dynamically)
```
---
## Installation
### Prerequisites
- Python 3.8+
- Pip package manager
### Steps
1. Clone the repository:
```bash
git clone
cd
```
2. Install the required Python packages:
```bash
pip install -r requirements.txt
```
3. Run the application:
```bash
python app.py
```
4. Open the game in your browser:
```
http://127.0.0.1:5000
```
---
## Usage
1. **Home Page**:
- Enter your username.
- Select the grid size (4x4 or 6x6).
2. **Game Page**:
- Flip cards by clicking on them.
- Match pairs to complete the game.
- Your moves and time will be tracked.
3. **Session Records**:
- View the best score (least moves) and the shortest time for the session.
---
## Technologies Used
- **Backend**: Flask (Python)
- **Frontend**: HTML, CSS, JavaScript
---
## Contributing
Contributions are welcome! Please fork the repository and submit a pull request for any changes or improvements.
---