https://github.com/koompi/master-mouse
Master Mouse
https://github.com/koompi/master-mouse
game mouse
Last synced: 5 months ago
JSON representation
Master Mouse
- Host: GitHub
- URL: https://github.com/koompi/master-mouse
- Owner: koompi
- Created: 2026-01-21T03:56:49.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-23T17:34:14.000Z (5 months ago)
- Last Synced: 2026-01-26T22:12:32.999Z (5 months ago)
- Topics: game, mouse
- Language: TypeScript
- Homepage: https://mastermouse.koompi.org
- Size: 3.77 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Master Mouse Adventure
## 🎮 About The Game
**Master Mouse Adventure** is an interactive educational game designed to help children master computer mouse skills. Through a series of fun, Cambodian-themed mini-games, players will learn:
- **Clicking** (Balloon Pop, Fruit Chop)
- **Hovering** (Magic Garden, Flashlight)
- **Dragging & Dropping** (Toy Sorter, Temple Builder)
- **Scrolling** (Deep Sea Scroll)
- **Tracing** (Shape Tracing, Khmer Letters)
The game features **100+ levels** across different thematic chapters, from the "Happy Grass Garden" to the "Ice Mountain", keeping kids engaged while they build essential digital literacy skills.
## ✨ Features
- **Cambodian Theme**: Includes games like _Tuk Tuk Driver_, _Khmer Letter Tracing_, _Rice Planting_, _Angkor Temple Builder_, and more.
- **Progress Tracking**: Validates skills and unlocks new levels as the player progresses.
- **Offline Ready**: Fully functional without an internet connection.
- **PWA Support**: Can be installed as an App on your device.
- **Engaging Visuals**: Bright colors, animations, and sound effects to encourage learning.
## 🚀 How to Run
### Online (Web)
Visit our official link: [coming soon]
### Locally (Developers)
1. **Clone the repository**
```bash
git clone https://github.com/koompi/master-mouse.git
cd master-mouse
```
2. **Install dependencies**
```bash
# using bun
bun install
# OR using npm
npm install
```
3. **Start the development server**
```bash
# using bun
bun run dev
# OR using npm
npm run dev
```
4. **Build for production**
```bash
npm run build
```
## 📦 Build Desktop App (Electron)
To build the standalone desktop application (AppImage/Deb/Win):
```bash
npm run electron:build
```
The output files will be in the `release/` folder.
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## 📄 License
This project is licensed under the MIT License.
---
Built with ❤️ by [KOOMPI](https://koompi.com)