telegram-mini-app
Expert in building Telegram Mini Apps (TWA) - web apps that run inside Telegram with native-like experience. Covers the TON ecosystem, Telegram Web App API, payments, user authentication, and building viral mini apps that monetize. Use when: telegram mini app, TWA, telegram web
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Expert in building Telegram Mini Apps (TWA) - web apps that run inside Telegram with native-like experience. Covers the TON ecosystem, Telegram Web App API, payments, user authentication, and building viral mini apps that monetize. Use when: telegram mini app, TWA, telegram web app, TON app, mini app.
How to use
Zainstaluj skill w swoim środowisku Claude lub agenta, wskazując katalog telegram-mini-app z repozytorium davila7. Skill będzie dostępny jako ekspert do konsultacji przy budowie aplikacji Telegram Mini Apps.
Załaduj Telegram Web App API do swojego projektu, dodając tag skryptu https://telegram.org/js/telegram-web-app.js w sekcji head dokumentu HTML. Inicjalizuj obiekt Telegram.WebApp i wywołaj metody ready() oraz expand() w celu przygotowania aplikacji.
Dla projektów React użyj dostarczonego hooka useTelegram(), który opakowuje dostęp do API Telegrama. Hook zwraca obiekt tg, dane użytkownika, query_id oraz metody sterujące (expand, close, ready).
Zaimplementuj uwierzytelnianie użytkownika poprzez initDataUnsafe.user, które zawiera first_name, id i inne dane profilu. Dane te są automatycznie dostępne bez dodatkowych żądań API.
Zapytaj skill o wzorce integracji TON Connect dla płatności, mechaniki wirusowe (zapraszanie znajomych, dzielenie się) oraz optymalizację UX dla interfejsu Telegrama. Skill doradzi konkretne implementacje dla gier, DeFi, narzędzi i aplikacji społecznych.
Testuj aplikację w Telegramie poprzez link do Mini App, upewniając się, że rozszerza się na pełny ekran i reaguje na gesty mobilne zgodnie z paradygmatem UX Telegrama.