Telegram Mini App on TON.

Telegram Mini Apps live or die on three things: the WebApp SDK has to be present at runtime (we mock it in dev so the same code runs without Telegram injected), the game loop has to be rewarding within a single tap (mining rate visible immediately, first reward within seconds), and the leaderboard has to be fair across devices (which means state in a real database, not localStorage).

Our team built the full stack: a Next.js 15 frontend using the Telegram WebApp SDK injected via the standard script tag (with a `mockTelegramWebApp.js` shim for local development), Radix UI primitives for the in-Telegram dialogs, GSAP micro-animations on the mine button and progress arcs, Recharts for the leaderboard time series, and Zustand stores for client state. The Express + Prisma backend holds user state, tasks, referral trees, and leaderboard scores in MySQL so concurrent players see consistent ordering.

Onboarding is intentionally short: the user lands, taps once to claim the daily reward, mines a few times to see the cooldown, and gets pointed at tasks (join channel, invite friend, post in chat) that pay out across the next 24 hours. Admin can push new tasks live from an operator console — task form, payout config, audience targeting — and they go active immediately without a backend deploy.

Referral mechanics use Telegram's invite links with a server-validated attribution: the referral cookie is set on first open, the back-end credits the referrer only when the referee hits a configured milestone (first mine, first task, total mined > X), so invite spam doesn't farm the leaderboard.