telegram-mini-app

Develop Telegram Mini Apps using the Telegram Web App API and TON blockchain.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/gerald-ica/dev-tool-configs --skill telegram-mini-app-gerald-ica
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: telegram-mini-app
Source: https://github.com/gerald-ica/dev-tool-configs/tree/main/gemini/skills/telegram-mini-app
Command: npx skills add https://github.com/gerald-ica/dev-tool-configs --skill telegram-mini-app-gerald-ica

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @tonconnect/ui-react, telegram-web-app, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill addresses the challenge of building Telegram Mini Apps (TWA) with a native-like experience, covering the TON ecosystem, Telegram Web App API, payments, user authentication, and viral mini apps monetization.

Core Features & Use Cases

  • Telegram Web App API: Leverages the Telegram Web App API for building web apps within Telegram.
  • TON Blockchain Integration: Integrates with the TON blockchain for in-app payments and user authentication.
  • Mini App Monetization: Provides strategies for monetizing mini apps through TON payments, in-app purchases, and referral systems.

Quick Start

Build a Telegram Mini App using the telegram-mini-app skill and integrate TON Connect for wallet connections.

Frequently Asked Questions about telegram-mini-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Telegram Mini App with a native-like experience?▼

You can build a Telegram Mini App with a native-like experience by leveraging the Telegram Web App API to run web applications directly within the Telegram client. This approach handles user authentication and interface interactions seamlessly.

How do I integrate TON blockchain payments in a Telegram Web App?▼

Integrating TON blockchain payments in a Telegram Web App requires using TON Connect for wallet connections and processing in-app transactions. This enables monetization strategies like in-app purchases and referral systems within the mini app.

Do I need to know the TON ecosystem to develop Telegram Mini Apps?▼

Yes, developing these mini apps requires knowledge of the TON ecosystem, specifically for handling in-app payments and user authentication. Familiarity with the Telegram Web App API is also necessary to build the native-like experience.

What is the best way to monetize Telegram Mini Apps?▼

The best way to monetize Telegram Mini Apps is through TON blockchain payments, in-app purchases, and viral referral systems. This approach leverages the integrated TON ecosystem to process transactions directly within the web app.

Can I use TON Connect for user authentication in Telegram Mini Apps?▼

Yes, you can use TON Connect for user authentication and wallet connections in Telegram Mini Apps. It integrates with the TON blockchain to verify user identities and process in-app payments securely.

Why use the Telegram Web App API instead of standard web app frameworks?▼

Using the Telegram Web App API instead of standard frameworks allows your application to run directly within Telegram, providing a native-like experience. It also enables direct access to Telegram user authentication and TON blockchain in-app payments.