telegram-mini-app
sickn33/agentic-awesome-skills
Build web apps inside Telegram for 800M+ users with TON blockchain integration and native-like experience.
What is telegram-mini-app?
Expert guidance for creating Telegram Mini Apps (TWA)—web applications that run natively within Telegram. Covers the TON ecosystem, Web App API, user authentication, crypto payments, and viral mechanics for monetizable mini apps.
- Design and build Telegram Mini Apps using the Telegram Web App API
- Integrate TON blockchain for payments and decentralized functionality
- Implement user authentication and session management within Telegram
- Create viral mechanics and monetization strategies for mini apps
- Optimize UX for Telegram's native paradigm rather than traditional web
- Connect to TON wallets via TON Connect for crypto transactions
How to install telegram-mini-app
npx skills add https://github.com/sickn33/agentic-awesome-skills --skill telegram-mini-app- Familiarity with web development (HTML, CSS, JavaScript/TypeScript)
- Understanding of Telegram Bot API basics
- Knowledge of blockchain concepts (helpful for TON integration)
- A Telegram account and bot token for testing
How to use telegram-mini-app
- 1.Review the detailed guide in references/detailed-guide.md for complete procedures and safety requirements
- 2.Identify your mini app type (game, DeFi, utility, social) and core features
- 3.Set up a Telegram bot and obtain your Web App URL
- 4.Implement Telegram Web App API initialization and user authentication
- 5.Design your app's UX following Telegram's native paradigm guidelines
- 6.Integrate TON Connect if your app requires blockchain or crypto payments
- 7.Test thoroughly in Telegram's test environment before production deployment
- 8.Deploy and monitor your mini app for user engagement and monetization metrics
Use cases
- Building a game or entertainment mini app distributed to Telegram's user base
- Creating a DeFi utility or trading app leveraging TON blockchain
- Developing a social or utility app with native Telegram authentication
- Implementing crypto payment flows within a Telegram mini app
- Designing a viral mini app with referral and monetization mechanics
- Web developers building Telegram-native applications
- Blockchain developers targeting the TON ecosystem
- Product teams launching apps to Telegram's 800M+ user base
- Entrepreneurs building monetizable mini apps or games
- Teams integrating crypto payments into Telegram apps
telegram-mini-app FAQ
A web application that runs inside Telegram with a native-like experience, leveraging the Telegram Web App API. It provides access to Telegram's 800M+ user base without requiring a separate app download.
No. TON blockchain integration is optional and most useful for apps requiring crypto payments, DeFi functionality, or decentralized features. Many mini apps work without blockchain.
Common monetization strategies include in-app purchases, crypto payments via TON, ad networks, premium features, and viral referral mechanics that drive user acquisition.
Mini apps run in a WebView with limited access to device hardware, no background execution, and must comply with Telegram's policies. Always validate outputs and test in Telegram's environment.
Use Telegram's test environment with a test bot token, test in both mobile and desktop Telegram clients, and validate all TON blockchain interactions on testnet before mainnet deployment.
Full instructions (SKILL.md)
Source of truth, from sickn33/agentic-awesome-skills.
name: telegram-mini-app description: Expert in building Telegram Mini Apps (TWA) - web apps that run inside Telegram with native-like experience. Covers the TON ecosystem, Telegram Web App API, payments, user authentication, and building viral mini apps that monetize. risk: critical source: vibeship-spawner-skills (Apache 2.0) date_added: 2026-02-27
Telegram Mini App
Expert in building Telegram Mini Apps (TWA) - web apps that run inside Telegram with native-like experience. Covers the TON ecosystem, Telegram Web App API, payments, user authentication, and building viral mini apps that monetize.
Role: Telegram Mini App Architect
You build apps where 800M+ Telegram users already are. You understand the Mini App ecosystem is exploding - games, DeFi, utilities, social apps. You know TON blockchain and how to monetize with crypto. You design for the Telegram UX paradigm, not traditional web.
Expertise
- Telegram Web App API
- TON blockchain
- Mini App UX
- TON Connect
- Viral mechanics
- Crypto payments
Detailed Guide
Read the detailed guide before executing this skill. It retains the complete procedure and reference material. Treat its safety, prerequisites, and validation requirements as mandatory. For focused work, load the relevant sections; for end-to-end work, read the guide completely.
When to Use
- User mentions or implies: telegram mini app
- User mentions or implies: TWA
- User mentions or implies: telegram web app
- User mentions or implies: TON app
- User mentions or implies: mini app
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Related skills
More from sickn33/agentic-awesome-skills and the wider catalog.
test-driven-development
Write failing tests first to guide implementation, then refactor with confidence.
typescript-advanced-types
Master TypeScript's advanced type system: generics, conditional types, mapped types, and utility types for type-safe applications.
typescript-expert
Advanced TypeScript expert for type systems, performance, monorepos, and migrations.
ui-ux-designer
Expert UI/UX designer for design systems, accessibility-first interfaces, and modern design workflows.
ui-ux-pro-max
Comprehensive design guide with 50+ styles, 97 color palettes, and 99 UX guidelines for web and mobile apps.
unreal-engine-cpp-pro
Expert C++ development guide for Unreal Engine 5.x with UObject hygiene, performance patterns, and best practices.