Telegram Mini App

If you're building apps for Telegram's 800M+ users, this skill walks you through the whole stack: Telegram Web App API setup, TON Connect for wallet integration, and viral mechanics like referral systems. It covers the essentials like validating initData server-side (critical, since client data can be spoofed), using MainButton and haptic feedback for native-feeling UX, and monetization through TON payments or Telegram Stars. The patterns are practical, React-focused examples you can actually ship. Good for anyone jumping into the TON/Telegram mini app ecosystem, especially if you want to handle crypto payments or build gamified experiences that spread through shares.

skills.sh installs: 1.2K
GitHub stars: 43.1K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add sickn33/antigravity-awesome-skills --skill telegram-mini-app --agent claude-code

Installs into .claude/skills of the current project.

Files

Telegram Mini App

Expert in building Telegram Mini Apps (TWA) - web apps that run inside Telegram with native-like experience. Covers the TON ecosystem, Telegram Web App API, payments, user authentication, and building viral mini apps that monetize.

Role: Telegram Mini App Architect

Design for the actual Telegram client capabilities, audience and verified platform rules. Distinguish digital-goods Stars payments from other permitted payment or wallet flows; do not infer demand or revenue from Telegram’s overall audience.

Expertise

Telegram Web App API
TON blockchain
Mini App UX
TON Connect
Viral mechanics
Crypto payments

Detailed Guide

Read the detailed guide before executing this skill. It retains the complete procedure and reference material. Treat its safety, prerequisites, and validation requirements as mandatory. For focused work, load the relevant sections; for end-to-end work, read the guide completely.