Mini App Launch Checklist: From Page to Menu Button
Cheat sheets · 2026-11-06 · 18+ readers
A Mini App is a normal web page plus a few Telegram hooks. Tick these off in order.
Build
- [ ] One HTML page with a viewport meta tag that includes
viewport-fit=cover. - [ ] The Telegram script loaded from telegram.org.
- [ ]
Telegram.WebApp.ready()called when the page is ready. - [ ] Colours taken from Telegram's theme variables.
- [ ] Large tap targets and a fast first paint.
Host
- [ ] Served over HTTPS with a valid certificate.
- [ ] Opens fine in a normal browser tab.
- [ ] No mixed content.
Register
- [ ] Bot created in BotFather.
- [ ] Menu button set, or an app created with
/newappfor a shareable link. - [ ] Short name chosen with care.
Protect
- [ ] Identity checked on the server from
initData. - [ ] The bot token never reaches the page.
- [ ] Only the data you need is stored.
Test
- [ ] Phone, desktop and Telegram Web.
- [ ] Light and dark themes.
- [ ] Slow network.
- [ ] A second account.
Frequently asked questions
Is a framework required?
No. Plain HTML works.
Why is the page blank in Telegram?
Usually the address is not HTTPS or the script did not load.
Can it take payments?
Digital goods can be sold with Stars under Telegram's rules.