telegram-mini-app

Skill dla architektów aplikacji Telegram Mini Apps. Opanuj budowanie aplikacji webowych działających wewnątrz Telegrama z doświadczeniem zbliżonym do natywnego. Dowiedz się, jak integrować TON Connect, implementować płatności, uwierzytelniać użytkowników przez Telegrama i projektować aplikacje wirusowe. Obejmuje wzorce UX dla Mini Apps, mechaniki monetyzacji oraz integrację z ekosystemem blockchain TON.

1. 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.

2. 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.

3. 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).

4. 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.

5. 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.

6. 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.