Telegram Mini App Studio

The ultimate development and testing environment for Telegram Mini Apps. Build, test, and debug your apps locally with full support for Telegram's features, including Mini Apps 2.0 compatibility. You can the watch the full usage demo.

Features

• Local Testing: Test your Mini Apps locally without the need for HTTPS or tunneling solutions like ngrok.

• Simulated Telegram Environments: Experience Telegram Android and iOS environments with support for popups, haptic feedback with virtual device shakes, QR scanners, buttons, and more.

• Feature-rich Developer Console: Integrated Chrome DevTools console for debugging every simulated environment.

• Mini Apps 2.0 Ready: Fully compatible with the latest Mini Apps 2.0 features and updates. (WIP, Phase 2)

• Mock User Data: Simulate user interactions with customizable mock data for efficient debugging. Switch between user profiles with unique data for more robust app testing.

• Event and Method Support: Supports over 90% of Telegram Mini App events and methods, with ongoing development.

• Token and InitData Simulation: Sign and verify initData using a bot token, just like Telegram’s backend.

• Native-looking Floating Windows: Emulates the floating Mini App window experience, akin to mobile emulators.

• Familiar Developer UI: Inspired by VSCode with multiple tabs and projects, enhancing productivity.

demo-2-1080P-30FPS.mp4

---

Platforms Support

• Telegram Android
• Telegram iOS
• Telegram Desktop
• Telegram WebK
• Telegram WebA

Parameters Support

• initData
• initDataUnsafe
• version
• platform
• colorScheme
• themeParams
• isExpanded
• viewportHeight
• viewportStableHeight
• headerColor
• backgroundColor
• bottomBarColor
• isClosingConfirmationEnabled
• isVerticalSwipesEnabled

Managers Support

• BackButton
• MainButton
• SecondaryButton
• SettingsButton
• HapticFeedback
• CloudStorage*
• BiometricManager

Methods Support

• isVersionAtLeast
• setHeaderColor
• setBackgroundColor
• setBottomBarColor
• enableClosingConfirmation
• disableClosingConfirmation
• enableVerticalSwipes
• disableVerticalSwipes
• onEvent
• offEvent
• sendData*
• switchInlineQuery*
• openLink
• openTelegramLink
• openInvoice
• shareToStory
• showPopup
• showAlert
• showConfirm
• showScanQrPopup
• closeScanQrPopup
• readTextFromClipboard
• requestWriteAccess
• requestContact
• ready
• expand
• close

Events Support

• themeChanged
• viewportChanged
• mainButtonClicked
• secondaryButtonClicked
• backButtonClicked
• settingsButtonClicked
• invoiceClosed
• popupClosed
• qrTextReceived
• scanQrPopupClosed
• clipboardTextReceived
• writeAccessRequested
• contactRequested
• biometricManagerUpdated
• biometricAuthRequested
• biometricTokenUpdated

Custom Methods

• getRequestedContact*
• saveStorageValue*
• getStorageValues*
• deleteStorageValues*
• getStorageKeys*

Note: Items specified with * require a proper MTProto client up and running to communicate with real Telegram servers. This feature is not available right now, but planned to be implemented and logged in via a real Telegram Account.

---

Roadmap

Phase 1

This phase has started from October 2024 and ended until January 2025.

• Setup base project and essentials
• Add support for Telegram Android and iOS platforms.

Phase 2

This phase is planned for early to mid 2025.

• Full compatibility with Telegram Mini Apps 2.0.
• Add support for Telegram Desktop, WebK, and WebA platforms.
• Add support for auto-updates in app and streamline release process.

Phase 3

This phase is planned for mid to late 2025.

• Improve mock data customization and support real user account login.
• Support * marked features that require real user account.

License

This project is licensed under the MIT License.

Contact

Have questions or suggestions? Feel free to reach out!

Telegram: @Eyfan

Email: [email protected]