Telegram mini app development means building a web app in HTML and JavaScript that opens inside Telegram through a bot, using Telegram's Mini Apps JavaScript interface for login, theming, payments and sharing. In 2026 the rules are strict: digital goods must be sold in Telegram Stars, and any crypto feature must run on the TON blockchain with wallets connected through TON Connect. A focused mini app typically takes 200 to 700 hours to build, or about $8,000 to $28,000 at a $40 hourly rate.
Mini apps are the fastest way to put a product in front of Telegram's audience without an app store download. Pavel Durov now describes Telegram as having a billion-plus users, and Telegram said in June 2024 that over 400 million users interact with bots and mini apps every month.
This guide is written from Telegram's own documentation and developer terms. It covers what a mini app is, the rules that shape every build, the tech stack, a step-by-step tutorial, TON wallet integration, growth loops that work, the lessons of the tap-to-earn wave, and a cost model with the hours shown.
Key Takeaways
- A mini app is a web app inside Telegram. It launches from a bot, a link, the menu button or an inline button, and gets the user's identity in signed
initDatawith no separate login. - Telegram's terms set the business model. Digital goods sell only in Telegram Stars, crypto features must use TON, and wallets must connect through TON Connect.
- The platform is moving fast. Bot API 8.0 added full-screen mode, home screen icons and subscriptions; TON's currency became Gram in June 2026; and Telegram Serverless began hosting mini app front ends on 6 October 2026.
- Growth loops are built in, retention is not. Referral links, sharing and stories make mini apps spread, but the biggest 2024 tap-to-earn tokens trade 95 to 98.5 percent below their peaks.
- Cost follows hours. At $40 per hour, a utility mini app runs about $8,000 to $14,000, a game or loyalty app $16,000 to $28,000, and a TON wallet or DeFi mini app $24,000 to $40,000 before audits.
What Is a Telegram Mini App?
Telegram's Mini Apps documentation describes mini apps as web interfaces that run inside Telegram and can replace any website. They support seamless authorization, payments, notifications and Telegram's own theme colours, so the app looks native in light and dark mode.
Every mini app belongs to a bot. The bot owns the identity, sends messages and receives payments, while the mini app handles the interface. Users can open it from several places:
| Launch point | How users open it | Best for |
|---|---|---|
| Main Mini App | "Launch app" button on the bot's profile, the Apps tab in search, or a t.me/botusername?startapp link |
The primary product entry |
| Direct link | t.me/botusername/appname link shared anywhere |
Campaigns, referrals, QR codes |
| Menu button | Button beside the chat input | Returning users |
| Inline button | Button under a bot message | Checkout, booking, task flows |
| Keyboard button | Custom keyboard in the chat | Simple forms that send data back |
| Inline mode | Typing @bot in any chat |
Sharing content into group chats |
| Attachment menu | The attachment menu in any chat, once the user adds the bot | Tools people use across many chats |
Mini apps receive a signed initData string with the user's ID, name, language and launch context. Your server must validate it with HMAC-SHA-256 using a key derived from the bot token, and check auth_date to reject stale data. Telegram also lets third parties validate the data without the bot token, using a public-key signature added in Bot API 8.0.
Mini App, Bot or Native App: Which Do You Need?
Telegram mini app development is not always the right call. Use this decision table:
| Your product needs… | Chat bot | Mini app | Native app |
|---|---|---|---|
| Commands, alerts and simple replies | Best | Overkill | Overkill |
| Rich interface: catalogue, game, dashboard | Weak | Best | Strong |
| Login without passwords | Built in | Built in | Build it |
| Distribution through chats and groups | Strong | Strongest | Weak |
| Selling digital goods | Stars only | Stars only | App store billing |
| Heavy offline use, background tasks, deep device access | No | Limited | Best |
| Users outside Telegram | No | No | Yes |
For alert, trading or wallet bots that live in the chat itself, Pixel's guide to crypto Telegram bot development cost covers that path. When the audience extends beyond Telegram, a companion product from Pixel's mobile app development team often follows the mini app, once the concept is proven.
Telegram's Developer Terms: The Rules That Shape Your Build
Telegram's Terms of Service for Bot Developers decide more about your product than any framework choice. Read sections 6 and 7 before you write a line of code.
Digital goods must use Telegram Stars
Because Telegram's store apps follow Apple and Google rules, all digital goods and services must be sold exclusively in Telegram Stars. Physical goods can still use third-party payment providers. Telegram's Stars payments guide says invoices use the currency code XTR and an empty provider token, and that refunds go through refundStarPayment.
The terms add operational duties:
- Every bot selling digital goods must answer the
/paysupportcommand and handle payment disputes itself. - Earned Stars may not be usable for rewards or ads for up to 21 days, and they expire after 3 years if unused.
- Enabling topics in private chats makes all Stars purchases in that app subject to a 15 percent fee withheld by Telegram.
- Broadcasting above 30 messages per second costs 0.1 Stars per message and needs at least 100,000 Stars and 100,000 monthly active users.
Crypto must run on TON
Section 7 says any mini app with cryptocurrency functionality, in the app or its bot, must be built exclusively on The Open Network (TON). Tokens and NFTs must be issued on TON, and every wallet interaction, from login to signing, must go through TON Connect. Multichain wallets may manage other chains inside their own interface, and other wallet protocols are allowed only for bridging assets. Mini apps may not promote non-TON crypto assets or link to platforms that do. Telegram set 21 February 2025 as the deadline for existing apps to move to TON, and its blockchain guidelines give permitted and prohibited examples.
Gram, not Toncoin
On 1 June 2026, Durov announced that TON's native currency is becoming Gram, while TON remains the name of the blockchain. Update your copy, tickers and price feeds accordingly.
Tech Stack for Telegram Mini App Development
A mini app is a standard web project with a few Telegram-specific layers.
| Layer | Common choice | Telegram-specific work |
|---|---|---|
| Front end | React, Vue or Svelte with Vite or Next.js | Load telegram-web-app.js, read theme params, use MainButton, BackButton and safe area insets |
| Telegram SDK | Official window.Telegram.WebApp, or the community @telegram-apps/sdk |
Full-screen, home screen, sharing, haptics, DeviceStorage and SecureStorage |
| Backend | Node.js, Python or Go | Validate initData, issue sessions, handle bot webhooks and Stars payments |
| Hosting | Any HTTPS host, or Telegram Serverless | Fast first load on mobile networks |
| Database | PostgreSQL, Redis, or Serverless SQLite | Users keyed by Telegram ID |
| Blockchain (optional) | TON Connect UI, Tolk smart contracts | Manifest file, transaction signing, indexer |
Two 2026 changes are worth knowing. Bot API 9.0 (April 2025) added DeviceStorage and SecureStorage, so mini apps can keep data and secrets on the device. And on 6 October 2026, Telegram Serverless added mini app hosting: the front end deploys with the bot and is served from a tgcloud.ai address, with server-side endpoints called through Telegram.WebApp.Serverless.call. It runs JavaScript in V8 isolates with a built-in SQLite database. Telegram's documentation does not list pricing or quotas at the time of writing, so test it on a side project first.
Telegram Mini App Tutorial: From BotFather to Launch
Here is the creation path in seven steps, the same order Pixel uses on client builds:
- Create the bot in @BotFather and store the token in a secrets manager, never in front-end code.
- Register the mini app with BotFather's
/newappor set it as the bot's main mini app, with a short name for direct links. - Build the web front end and load Telegram's script. Call
ready()once the first screen renders, andexpand()orrequestFullscreen()where the design needs space. - Validate
initDataon the server on every session start, checking the hash andauth_date, and only then trust the user ID. - Add payments: Stars invoices for digital goods, a provider token for physical goods, plus refunds and
/paysupport. - Test in every client. Telegram renders mini apps in iOS, Android, desktop and web clients, and each handles keyboards, safe areas and full-screen slightly differently.
- Launch with a direct link and a referral parameter, then watch first-load time and day-7 retention more than installs.
TON Mini Apps and Wallet Connect
A TON wallet mini app, or any mini app that touches crypto, follows the TON Connect get-started guide. The steps are short but unforgiving:
- Publish
tonconnect-manifest.jsonover HTTPS with your app's URL, name and a 180 by 180 pixel PNG icon. It must load without CORS limits, login or bot challenges, or wallets refuse to connect. - Pick the SDK. TON's docs recommend
@tonconnect/ui-reactfor React and Next.js,@tonconnect/uifor other frameworks, and@tonconnect/sdkwhen you build your own interface. - Write contracts in Tolk, which TON documents as its official smart contract language, and get them audited before mainnet.
The user side changed in 2026. Telegram began rolling out its built-in Gram wallet on 31 August 2026, and TON's documentation describes Telegram Money as a non-custodial wallet with five sponsored free transfers a day, an encrypted cloud backup split across three continents, and TON Connect sessions that sync across devices. For mini app builders, that means many users now arrive with a wallet already inside Telegram, which removes the biggest onboarding step crypto apps used to have.
If a full wallet is the product, Pixel's crypto wallet development starts from $5,000, and a white label crypto wallet can shorten the build further. Note that wallets, exchanges and token sales carry licensing duties in many countries, including VARA licensing in Dubai for virtual asset services.
Growth Loops That Work Inside Telegram
Telegram gives mini apps distribution tools that websites do not have. The ones that matter most:
- Referral deep links. A
startappparameter carries a referral code into the app, so every user can invite friends with one link. - Native sharing. Since Bot API 8.0, mini apps can open a share dialog for a message prepared by the bot, and since Bot API 7.8 they can open the story editor with your media.
- Home screen icons. Bot API 8.0 lets users add the mini app to the phone's home screen, which turns a chat link into a daily habit.
- Emoji statuses. Premium users can set a status from inside the app, showing friends they are playing or using it, as Telegram's Mini Apps 2.0 announcement explains.
- Subscriptions in Stars. Recurring plans in Stars let you sell premium tiers without leaving Telegram.
- Bot messages. The bot can re-engage users with messages, within Telegram's broadcast limits.
- Telegram Ads paid in Stars. The terms allow Stars earned by your app to buy ads for that same app.
Localise early. Teams targeting Singapore, Southeast Asia, Turkey, the UAE and Brazil should ship language packs keyed to the user's language code in initData on day one, and upload translated media previews for the main mini app's profile, which Telegram shows by app language.
What the Tap-to-Earn Wave Teaches
In 2024, tap-to-earn games such as Notcoin, Hamster Kombat, Catizen and DOGS drew huge audiences through exactly these growth loops, then launched tokens. CoinGecko's market data in mid October 2026 shows what happened next:
| Token | All-time high (date) | Price, mid October 2026 | Change from peak | Market cap |
|---|---|---|---|---|
| Notcoin (NOT) | $0.0284 (2 Jun 2024) | $0.00042 | Down 98.5% | $41.9 million |
| DOGS | $0.00163 (28 Aug 2024) | $0.00004 | Down 97.6% | $20.6 million |
| Hamster Kombat (HMSTR) | $0.0072 (26 Sep 2024) | $0.00016 | Down 97.8% | $10.1 million |
| Catizen (CATI) | $1.11 (20 Sep 2024) | $0.053 | Down 95.2% | $35.1 million |
| Gram, formerly Toncoin | $8.25 (14 Jun 2024) | $1.38 | Down 83.3% | $3.91 billion |
Figures come from CoinGecko market data. DeFiLlama puts TON chain TVL near $50 million in October 2026.
The lesson is not that mini apps fail. It is that rewards bought attention, and attention left when rewards stopped. Build loops around something users keep wanting: a service, a game worth playing without a token, or a loyalty scheme tied to real purchases. Treat a token as a feature to add later, not the reason the app exists.
How Much Does Telegram Mini App Development Cost?
Pixel Web Solutions does not publish a fixed mini app price, so the ranges below are estimates built from engineering hours at Pixel's custom rate from $40 per hour.
| Mini app type | Typical scope | Estimated hours | Estimated cost at $40/hour |
|---|---|---|---|
| Utility or commerce | Catalogue or booking, initData login, Stars or provider payments, light admin |
200 to 350 | $8,000 to $14,000 |
| Game or loyalty | Gameplay, leaderboards, referrals, Stars shop, admin and analytics | 400 to 700 | $16,000 to $28,000 |
| TON wallet or DeFi | TON Connect, jetton transfers, Tolk contracts, indexer, security review | 600 to 1,000 | $24,000 to $40,000, plus a third-party audit |
| Mini app plus native app | Any of the above with iOS and Android companions | Add 500 to 1,000 | Add $20,000 to $40,000 |
Worked example: a loyalty mini app for a retail brand
A Singapore retail chain wants a mini app where customers collect points, refer friends and buy digital vouchers in Stars.
| Module | Hours |
|---|---|
| UX and UI design for Telegram themes | 60 |
| Front end: React, Telegram SDK, MainButton, BackButton, safe areas | 160 |
Backend: initData validation, users, points ledger |
60 |
Stars shop: invoices, refunds, /paysupport |
32 |
Referral and sharing loops: startapp, share dialog, stories |
60 |
| Admin dashboard and analytics | 80 |
| QA across iOS, Android, desktop and web clients | 60 |
| BotFather setup and launch | 12 |
| Total | 524 |
Maths: 524 hours x $40 = $20,960. Monthly running costs then depend on hosting and traffic. A small app fits on a modest server, and Telegram Serverless may lower that once its pricing is published. For broader app budgets, Pixel's guide on the cost to create a mobile app shows how the same hourly maths scales to native builds.
Checklist Before You Start Telegram Mini App Creation
- Does the product need a rich interface, or would a chat bot do?
- Are digital goods priced in Stars, with refunds and
/paysupportready? - Is every crypto feature on TON, with TON Connect for all wallet actions?
- Does the server validate
initDataon every session? - Is first load under a few seconds on a mid-range Android phone and mobile data?
- Will users come back without rewards? If not, fix the core loop before launch.
- Do your crypto features need a license where your users live?
How Pixel Web Solutions Can Help
Pixel Web Solutions builds Telegram mini apps, bots and TON integrations, from Stars-based commerce and loyalty apps to TON Connect wallets and TON smart contracts, with initData validation and multi-client QA as standard. It is a UAE and India based company with offices in Ras Al Khaimah, UAE and Madurai, India, and custom work starts from $40 per hour. For blockchain-heavy products, Pixel's Web3 development company team handles contracts, indexers and wallet flows alongside the mini app. To scope your app in hours rather than guesses, contact Pixel Web Solutions.
Frequently Asked Questions
What is a Telegram mini app?
A Telegram mini app is a web application that runs inside Telegram, opened from a bot, a link or a button. It uses Telegram's JavaScript interface for login, theme, payments and sharing, so users never need to install anything or create a password.
How do I create a Telegram mini app?
Create a bot in @BotFather, register a mini app for it, build a web front end that loads Telegram's telegram-web-app.js script, host it over HTTPS, and validate the signed initData on your server. Then add Stars payments if you sell digital goods, test in every Telegram client, and launch with a direct link.
Do Telegram mini apps have to use TON?
Yes, if they include any crypto functionality. Telegram's developer terms require crypto features to run exclusively on TON and wallet interactions to go through TON Connect. Mini apps without crypto features can use any technology.
Can a Telegram mini app accept card payments?
For physical goods and services, yes, through Telegram's supported payment providers. For digital goods and services, no: Telegram's terms require Telegram Stars, which users buy through in-app purchases.
How much does it cost to build a Telegram mini app?
At $40 per hour, a simple utility mini app costs about $8,000 to $14,000, a game or loyalty app $16,000 to $28,000, and a TON wallet or DeFi mini app $24,000 to $40,000 before a smart contract audit. These are estimates based on hours, not fixed prices.
How long does Telegram mini app development take?
A focused utility app takes around 200 to 350 hours, which is roughly 5 to 9 weeks for one full-time developer working with a designer. Games and wallet apps take longer because of gameplay tuning, security work and contract audits.
Can I build a Telegram mini app without a server?
Partly. Telegram Serverless now hosts mini app front ends and runs back-end JavaScript with a built-in database on Telegram's infrastructure, added on 6 October 2026. Check its current limits before relying on it for payments or high traffic.
Telegram mini app development in 2026 rewards teams that follow Telegram's rules from the first sprint: Stars for digital goods, TON and TON Connect for crypto, validated initData, and growth loops tied to something users want to keep using. Price the build in hours, test it in every client, and launch small before you scale.
