Telegram Mini App

If you're building apps for Telegram's 800M+ users, this gets you up to speed on the Mini App ecosystem. It covers the Telegram Web App API, TON blockchain integration for crypto payments, and viral mechanics that actually work in the platform. The patterns show React setup with hooks, TON Connect for wallet connections, and monetization through Telegram Stars and referrals. Sharp edges call out critical stuff like validating initData server-side and mobile-specific TON Connect issues. The anti-patterns are honest about common mistakes like ignoring mobile-first design or the Telegram theme system. Solid if you're serious about building where Telegram users already hang out.

skills.sh installs: 420
GitHub stars: 33.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add davila7/claude-code-templates --skill telegram-mini-app --agent claude-code

Installs into .claude/skills of the current project.

Files

Telegram Mini App

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.

Capabilities

Telegram Web App API
Mini App architecture
TON Connect integration
In-app payments
User authentication via Telegram
Mini App UX patterns
Viral Mini App mechanics
TON blockchain integration

Patterns

Mini App Setup

Getting started with Telegram Mini Apps

When to use: When starting a new Mini App

## Mini App Setup

### Basic Structure
```html
<!DOCTYPE html>
<html>
<head>
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <script src="https://telegram.org/js/telegram-web-app.js"></script>
</head>
<body>
  <script>
    const tg = window.Telegram.WebApp;
    tg.ready();
    tg.expand();

    // User data
    const user = tg.initDataUnsafe.user;
    console.log(user.first_name, user.id);
  </script>
</body>
</html>

SKILL.md on GitHub