telegram-mini-app_skill

This skill helps you build Telegram Mini Apps with TON integration, leveraging Web App API, crypto payments, and viral UX to monetize.

Python

21

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill omer-metin/skills-for-antigravity --skill telegram-mini-app

SKILL.md1.6 KB

Overview

This skill is an expert guide and implementation assistant for building Telegram Mini Apps (TWA) that deliver native-like experiences inside Telegram. It covers Telegram Web App API, TON blockchain integration, user authentication, payments via TON Connect and crypto rails, and growth patterns for viral distribution and monetization. Use it to design, validate, and troubleshoot mini apps tailored to the Telegram UX and TON ecosystem.

How this skill works

I analyze your app concept and technical design against proven Mini App patterns, common failure modes, and strict validation rules used in production. I recommend concrete architecture, API usage, authentication flows, payment integration, and UX patterns optimized for Telegram Web App behavior. I also surface critical risks—privacy, session handling, payment reconciliation, and cross-platform quirks—and prescribe fixes and tests.

When to use it

Designing a new Telegram Mini App or porting a web app into Telegram
Implementing authentication and user identity via Telegram and TON Connect
Integrating crypto payments or on‑ramp/off‑ramp flows with TON
Optimizing UX and lifecycle for in‑chat, modal, and inline mini apps
Diagnosing production issues like session loss, payment failures, or platform incompatibilities

Best practices

Design for Telegram UX: keep flows short, avoid long redirects, and prefer async updates for in‑chat contexts
Use official Web App APIs for authentication and state; persist minimal server-side session data
Integrate TON Connect for wallets and crypto payments; ensure idempotent payment handling and server verification
Plan for edge cases: network drops, WebView resizes, repeated callbacks, and race conditions with payments
Instrument and validate every flow against strict rules: input validation, signature checks, and reconciled accounting

Example use cases

A social mini game that uses TON for in‑game purchases and viral invites to groups
A DeFi dashboard embedded in Telegram with wallet connect and quick trade UX
A utility bot that opens a mini app for premium features and collects crypto payments
A viral sticker or content generator that monetizes via one‑tap purchases and share hooks

FAQ

Yes. Use TON Connect and server‑side verification to accept and reconcile crypto payments securely; design for idempotency and user feedback on transaction state.

How do I handle user identity and sessions?

Prefer Telegram Web App user info for initial identity, persist minimal server sessions, and revalidate signatures on reconnect. Combine with wallet auth for crypto actions.