TSocial TSocial
Open in Telegram
Better in TelegramOpen in Telegram
TSocial planet logoTelesocial

Telesocial › Cheat sheets

Mini App Launch Checklist: From Page to Menu Button

Cheat sheets · 2026-11-06 · 18+ readers

A Mini App icon (grid) 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 code icon HTTPS with a valid certificate.
  • [ ] Opens fine in a normal browser tab.
  • [ ] No mixed content.

Register

  • [ ] Bot created in bot icon BotFather.
  • [ ] Menu button set, or an app created with /newapp for a shareable link icon 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 Telegram Stars star icon Stars under Telegram's rules.

More cheat sheets

Mini App Launch Checklist: From Page to Menu Button | Telesocial