memory-match
Classic card-matching memory game with multiple difficulty levels, timer, moves counter, and statistics. Train your brain while having fun!
Purpose
Created to provide a fun, brain-training memory game that helps improve cognitive skills through pattern recognition and recall. Features multiple difficulty levels, beautiful card animations, and progress tracking.
Tech Stack
Tags
Startup Command
/root/ily.dog/venv/bin/python app.py
Run from project directory: /root/ily.dog/apps/memory-match
README
🧠 Memory Match
A beautiful card-matching memory game to train your brain! Flip cards to find matching pairs and track your progress with detailed statistics.
Features
- Multiple Difficulty Levels - Easy: 4×4 grid (8 pairs) - Medium: 6×6 grid (18 pairs) - Hard: 8×8 grid (32 pairs)
- 5 Card Themes - 🐾 Animals - Cute animal emojis - 🍕 Food - Delicious food items - 🌸 Nature - Beautiful nature symbols - 🚀 Space - Space and celestial objects - 🎁 Objects - Fun everyday items
- Gameplay Features - Smooth card flip animations - Real-time timer - Move counter - Pairs matched tracker - Win celebration modal
- Statistics Tracking - Games played per difficulty - Best time records - Best moves records - Average performance - Recent game history
- Start with Easy mode to learn the patterns
- Try to remember card positions as you flip them
- Fewer moves = better score!
- Challenge yourself with harder difficulties
- Backend: Flask (Python)
- Database: SQLite for statistics persistence
- Frontend: HTML5, CSS3, JavaScript
- Animations: CSS3 3D transforms for card flips
- Design: Responsive, works on desktop and mobile
How to Play
1. Select Difficulty - Choose Easy, Medium, or Hard 2. Choose Theme - Pick your favorite card theme 3. Click "New Game" - Start a fresh game 4. Match Pairs - Click cards to flip them and find matching pairs 5. Win - Match all pairs to complete the game!
Tips
Technical Stack
Running
cd /root/ily.dog/apps/memory-match
/root/ily.dog/venv/bin/python app.py
The app runs on port 5050.
API Endpoints
| Endpoint | Method | Description |
|----------|--------|-------------|
| / | GET | Main game page |
| /api/start-game | POST | Start new game (returns shuffled cards) |
| /api/complete-game | POST | Record completed game |
| /api/statistics | GET | Get player statistics |
| /api/themes | GET | Get available themes |
Files Structure
memory-match/
├── app.py # Flask application
├── manifest.yaml # App configuration
├── memory.db # SQLite database (auto-created)
├── README.md # This file
├── static/
│ ├── css/
│ │ └── style.css # Game styles
│ └── js/
│ └── game.js # Game logic
└── templates/
└── index.html # Main template
---
Made with ❤️ for the ily.dog platform
Train your memory daily for better cognitive health!
Project Location: /root/ily.dog/apps/memory-match