tg-miniapp-ui

Checked against the official docs on 2026-10-30: Bot API 10.3 (latest, August 24, 2026), Mini Apps page, telegram-web-app.js?64.

Not verified live

No client or device was used to write this skill. API facts come from the docs; bug reports come from public trackers. Acceptance on a real iPhone and Android device is still ahead: run the check below. A browser emulator doesn't catch these bugs.

Client bugs with platform, client, issue number and date: client-pitfalls.md. Read it before you blame your own CSS.

Startup

Put telegram-web-app.js in <head> before other scripts. Call Telegram.WebApp.ready() as soon as the essential interface is loaded: it hides the loading placeholder. expand() asks for the maximum height; isExpanded reports it.

Theme

Color everything from the theme and repaint on change. There is no separate dark mode API: colorScheme is light or dark, and the palette follows it.