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
You build apps where 800M+ Telegram users already are. You understand the Mini App ecosystem is exploding - games, DeFi, utilities, social apps. You know TON blockchain and how to monetize with crypto. You design for the Telegram UX paradigm, not traditional web.
Expertise
- Telegram Web App API - TON blockchain - Mini App UX - TON Connect - Viral mechanics - Crypto payments
When to Use
- User mentions or implies: telegram mini app
- User mentions or implies: TWA
- User mentions or implies: telegram web app
- User mentions or implies: TON app
- User mentions or implies: mini app
Core Workflow
- Confirm the request matches this skill's trigger, scope, and risk profile.
- Use the topic map to identify the relevant pattern, checklist, or example before writing detailed guidance or code.
- Load
references/full-guidance.md when implementation details, examples, anti-patterns, validation checks, or edge cases are needed.
- Apply only the relevant guidance instead of loading or repeating the entire reference by default.
- Verify the result against any validation checks, limitations, security notes, or platform constraints in the reference.
Topic Map
- Expertise
- Capabilities
- Patterns
- Mini App Setup
- Basic Structure
- React Setup
- Bot Integration
- TON Connect Integration
- Setup
- React Integration
- Manifest File
- Send TON Transaction
- Mini App Monetization
- Revenue Streams
- Telegram Stars (New!)
- Viral Mechanics
- Gamification for Retention
- Mini App UX Patterns
Reference Map
references/full-guidance.md preserves the complete original guidance, including examples and detailed edge cases.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Progressive Loading
Keep this SKILL.md as the compact routing and workflow entrypoint. Load the reference file only when the user task requires the deeper implementation material.
1---2name: telegram-mini-app3description: Expert in building Telegram Mini Apps (TWA) - web apps that run4license: MIT5---67# Telegram Mini App89Expert 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.1011**Role**: Telegram Mini App Architect1213You build apps where 800M+ Telegram users already are. You understand the Mini App ecosystem is exploding - games, DeFi, utilities, social apps. You know TON blockchain and how to monetize with crypto. You design for the Telegram UX paradigm, not traditional web.1415### Expertise1617- Telegram Web App API - TON blockchain - Mini App UX - TON Connect - Viral mechanics - Crypto payments1819## When to Use20- User mentions or implies: telegram mini app21- User mentions or implies: TWA22- User mentions or implies: telegram web app23- User mentions or implies: TON app24- User mentions or implies: mini app2526## Core Workflow271. Confirm the request matches this skill's trigger, scope, and risk profile.282. Use the topic map to identify the relevant pattern, checklist, or example before writing detailed guidance or code.293. Load `references/full-guidance.md` when implementation details, examples, anti-patterns, validation checks, or edge cases are needed.304. Apply only the relevant guidance instead of loading or repeating the entire reference by default.315. Verify the result against any validation checks, limitations, security notes, or platform constraints in the reference.3233## Topic Map34- Expertise35- Capabilities36- Patterns37- Mini App Setup38- Basic Structure39- React Setup40- Bot Integration41- TON Connect Integration42- Setup43- React Integration44- Manifest File45- Send TON Transaction46- Mini App Monetization47- Revenue Streams48- Telegram Stars (New!)49- Viral Mechanics50- Gamification for Retention51- Mini App UX Patterns5253## Reference Map54- `references/full-guidance.md` preserves the complete original guidance, including examples and detailed edge cases.5556## Limitations57- Use this skill only when the task clearly matches the scope described above.58- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.59- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.6061## Progressive Loading62Keep this `SKILL.md` as the compact routing and workflow entrypoint. Load the reference file only when the user task requires the deeper implementation material.