# telegram-mini-app

Plan Telegram Mini Apps with guidance on the Web App API, TON Connect, payments, and Telegram user data. Useful when building a web app that runs inside Telegram.

- skill · `type=skill` · Claude Code · 128 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/enterprise-communication/telegram-mini-app
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/telegram-mini-app

## What it does

This skill covers Mini App structure, Telegram Web App API calls, and access to user information supplied by Telegram. It includes a basic HTML approach and a React hook pattern for reading user data and calling `ready`, `expand`, and `close`. A bot example shows how to open the app from a command.

For Web3 projects, the material walks through TON Connect setup in React, wallet connection, and sending a TON transaction. Other sections cover Telegram Stars invoices, referral links, and game rewards. These are implementation patterns, not a packaged Mini App. Validate Telegram `initData`; the skill flags skipping that check as a serious security issue.

The guidance also addresses Telegram themes, mobile-first layouts, and loading states. TON Connect on mobile is listed as a trouble spot, so test that flow on the phones you plan to support.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill enterprise-communication/telegram-mini-app
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill telegram-mini-app -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/telegram-mini-app/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/telegram-mini-app/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/telegram-mini-app/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/telegram-mini-app/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates telegram-mini-app
```

2. **Manually: put the files in place**
- File: `.github/skills/telegram-mini-app/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/enterprise-communication/telegram-mini-app
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/telegram-mini-app/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/enterprise-communication/telegram-mini-app

## When to use it
- wire the Telegram Web App API into an interface
- read Telegram user data in a Mini App
- connect a TON wallet and send a transaction
- add Telegram Stars payments through a bot
- create a referral flow for a Mini App

## Example prompts
- Plan a React Mini App and add a hook for Telegram Web App data and controls.
- Set up TON Connect and add a button that sends a TON transaction.
- Add a Telegram Stars payment flow and a referral link to the app.

## Similar
- [access](https://affpapa.org/en/nevibecode/skills/access-2.md) — skill · 3867 installs
- [configure](https://affpapa.org/en/nevibecode/skills/configure-2.md) — skill · 3861 installs
- [claude-to-im](https://affpapa.org/en/nevibecode/skills/claude-to-im.md) — skill · 7100 installs
- [mode-creator](https://affpapa.org/en/nevibecode/skills/mode-creator.md) — skill · 1300 installs
- [telegram-bot-builder](https://affpapa.org/en/nevibecode/skills/sickn33-telegram-bot-builder.md) — skill · 3700 installs
- [chat-sdk](https://affpapa.org/en/nevibecode/skills/vercel-chat-sdk.md) — skill · 5400 installs

## Other versions with the same name
- [telegram-mini-app · sickn33](https://affpapa.org/en/nevibecode/skills/sickn33-telegram-mini-app.md) — 1700 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md