telegram-mini-apps

Use when building Telegram Mini Apps (TWA) — WebApp SDK integration, initData validation, storage APIs, theming, and device features. Also use when debugging initData HMAC validation or implementing SecureStorage.

Model	Source
inherit	pack: telegram

Overview

Item	Value
Platform	Telegram Mini Apps (formerly Web Apps / TWA)
SDK	window.Telegram.WebApp (injected by Telegram client)
Bot API min	6.1 (basic), 9.0+ (DeviceStorage, SecureStorage)
Docs	core.telegram.org/bots/webapps

Full Reference

┏━ 🔧 telegram-mini-apps ━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Telegram Mini Apps SDK + storage reference ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Telegram Mini Apps

Overview

Item	Value
Platform	Telegram Mini Apps (formerly Web Apps / TWA)
SDK	window.Telegram.WebApp (injected by Telegram client)
Bot API min	6.1 (basic), 9.0+ (DeviceStorage, SecureStorage)
Docs	core.telegram.org/bots/webapps

Reference Index

File	Contents
reference/webapp-sdk.md	WebApp SDK — initialization, initData validation, MainButton, BackButton, theming, events
reference/storage.md	Storage APIs — CloudStorage, DeviceStorage, SecureStorage, comparison and usage patterns

Usage: Read the reference file matching your current task. Each file has working code examples and inline gotchas.

Quick Start

<script src="https://telegram.org/js/telegram-web-app.js"></script>
<script>
  const tg = window.Telegram.WebApp;
  tg.ready();
  tg.expand();
  console.log('User:', tg.initDataUnsafe.user);
</script>