What are Mini Apps?
Telegram Mini Apps (TMAs) are web applications that run within the Telegram messenger. They are built using web technologies — HTML, CSS, and JavaScript.
Mini Apps run through Telegram and are instantly accessible to its 900+ million users — without the need for installs or redirects.
Key features
- Telegram integration: Mini Apps run directly within Telegram, with support for launching from chats, groups, or inline queries—no installation required.
- Cross-platform support: work consistently across Android, iOS, Windows, macOS, and Linux.
- Push notifications: bots can send updates and alerts to users at any time, even when the Mini App is not active.
- User authentication: securely authenticate users using Telegram’s built-in login mechanism, with signed user data passed to the app.
- Bot interaction: bots handle backend processing, user interaction, session state, and real-time messaging.
- Web-based development: built with HTML, CSS, JavaScript, leveraging Telegram’s APIs to create feature-rich applications.
- Integrated payments: support over 20 providers, including Google Pay and Apple Pay.
- Monetization: subscriptions, in-app purchases, and advertising models are supported.
- Web3 & TON support: support TON SDK, TON Connect, and token-based transactions, allowing seamless integration with blockchain-powered applications.
- Community development: Telegram has a strong developer ecosystem, where third-party developers actively create and share TMAs, fostering innovation and diversity.
Developer resources
TMA documentation
- Telegram Mini Apps documentation — community-driven documentation for TMA.
- TMA documentation by Telegram — full description on the Telegram website.
Telegram developers community
Join the Telegram developers chat to discuss Mini Apps development and get support:
Join chat
Mini Apps SDKs
| Repository | Description |
|---|---|
| twa-dev/sdk | NPM package for the TWA SDK. |
| twa-dev/boilerplate | a boilerplate for a new TWA |
| twa-dev/Mark42 | a simple, lightweight, tree-shakable UI library for TWA |
| ton-defi-org/tonstarter-twa | a template for a new TWA interacting with TON |
Since TMAs are web pages and use JavaScript, you need to choose JS/TS-based SDK.
Integrate with TON Connect
Use the TON Connect protocol to establish a secure connection between your TMA and users' wallets. It enables authentication, transaction signing, and on-chain data access.
Discover TON Connect
Build your TMA
Follow a complete walkthrough or explore examples to start building your own TMA.
Step-by-step guide
See examples