A free, open-source Hamster Kombat clone — the perfect starting point to learn how to build a Telegram Mini App tap-to-earn game from scratch.
See a complete, production-ready Telegram Mini App in action — game, Telegram Stars & TON payments, referrals, leaderboard, tasks system, and an admin panel:
🎮 Or play the live demo right now: @ViralTgGameBot
This repository is a free Telegram Mini App tutorial — a clone of the popular Hamster Kombat tap-to-earn game. It gives you the foundational structure, images, and icons to learn how Telegram Mini Apps are built with Next.js, React, and TypeScript.
It ships in two branches so you can learn at your own pace:
| Branch | What it contains |
|---|---|
initial-setup |
The foundational project structure and assets to build from |
final-version |
The completed clone with all functionality |
💡 Want more than a clone? This repo is a great way to learn the basics. If you want a complete, launch-ready Telegram Mini App with payments, referrals, tasks, an admin panel, and anti-cheat — check out the full source code below.
- 🎮 Tap-to-earn game mechanics (Hamster Kombat style)
- ⚡ Built with Next.js + React + TypeScript
- 📱 Designed for the Telegram Mini App (Web App) platform
- 🎨 Includes all images, icons, and UI assets
- 🧩 Clean, beginner-friendly project structure
- 🆓 100% free and open source
git clone https://github.com/nikandr-surkov/Hamster-Kombat-Telegram-Mini-App-Clone.git
cd Hamster-Kombat-Telegram-Mini-App-Clone🟢 Initial Setup (start here to build it yourself)
git checkout initial-setup
npm install
npm run devThen open your browser at http://localhost:3000.
✅ Final Version (the completed clone)
git checkout final-version
npm install
npm run devThen open your browser at http://localhost:3000.
This clone is perfect for learning. But launching a real product means handling payments, growth, security, and scale — and that takes weeks of work.
👉 My Complete Telegram Mini App source code does it all for you. It's a full, production-ready system you can rebrand and launch for your own game, crypto project, community, meme coin, or NFT project.
🎮 See it live first: play the demo on Telegram → @ViralTgGameBot
| Feature | Free Clone (this repo) | Complete Source Code |
|---|---|---|
| Tap-to-earn / in-app game | ✅ | ✅ (physics merge game) |
| Modern Next.js + TypeScript stack | ✅ | ✅ |
| Telegram Stars payments | ❌ | ✅ |
| TON crypto payments + verification | ❌ | ✅ |
| Referral system (viral loop) | ❌ | ✅ |
| Leaderboard, levels & daily rewards | ❌ | ✅ |
| Tasks & quests system | ❌ | ✅ |
| Admin panel (no-code task management) | ❌ | ✅ |
| Wallet collection (airdrops/Web3) | ❌ | ✅ |
| Server-side anti-cheat & rate limiting | ❌ | ✅ |
| Database, auth & production deployment | ❌ | ✅ |
| Step-by-step setup video + updates | ❌ | ✅ |
How do I build a Telegram Mini App?
A Telegram Mini App is a web app (built with frameworks like Next.js/React) that runs inside Telegram. This repo shows you the basics; the full video review and complete source code show you how to ship a production-ready one.Is this Hamster Kombat clone free?
Yes — this repository is completely free and open source for learning.How do I add Telegram Stars or TON payments to my mini app?
Payments, on-chain TON verification, referrals, tasks, and an admin panel are all included in the Complete Telegram Mini App source code. Watch the full review or play the live demo to see them working.What tech stack does it use?
Next.js, React, TypeScript — and the premium version adds PostgreSQL, Redis, TON Connect, and deploys to Vercel.I create premium content and source code for Telegram Mini App developers.
- 🌐 Website: https://nikandr.com
- 📺 YouTube: https://www.youtube.com/@NikandrSurkov
- 📢 Telegram Channel: https://t.me/NikandrApps
- 📱 Telegram: https://t.me/nikandr_s
- 💻 GitHub: https://github.com/nikandr-surkov
- 🐦 Twitter / X: https://x.com/NikandrSurkov
- 💼 LinkedIn: https://www.linkedin.com/in/nikandr-surkov/
- ✍️ Medium: https://medium.com/@NikandrSurkov
Built with ❤️ for the Telegram developer community
Keywords: Telegram Mini App, Hamster Kombat clone, Telegram Mini App source code, tap to earn game, Telegram Mini App tutorial, build Telegram Mini App, Telegram bot game, TON Telegram app, Telegram Stars payments, Next.js Telegram Mini App, Web3 Telegram game, crypto Telegram app.