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.