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

   git clone https://github.com/koompi/master-mouse.git
   cd master-mouse

2. Install dependencies

   # using bun
   bun install
   
   # OR using npm
   npm install

3. Start the development server

   # using bun
   bun run dev
   
   # OR using npm
   npm run dev

4. Build for production

   npm run build

📦 Build Desktop App (Electron)

To build the standalone desktop application (AppImage/Deb/Win):

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