Mini App Features

This page outlines all the features available in Mini Apps.

Core

These are the core modules that most of the features depend on:

• Launch Parameters — read parameters passed to the app when it was launched.
• WebView Bridge — communicate with the hosting Telegram client.

Essentials

Essential app lifecycle and behavior controls:

• Lifecycle — signal when app is ready, track whether it's active, etc.
• Closing Behavior — control app closing behavior.
• Swipes Behavior — control swipe gestures behavior.
• Orientation Behavior — control device orientation lock behavior.
• Links — open Telegram and external links.

Interface

Features for controlling visual elements and appearance of the app:

• Theming — adjust app appearance based on user's color theme.
• Viewport — control viewport dimensions and safe area insets.
• Fullscreen — control fullscreen mode of the app.
• Bottom Buttons — control main and secondary buttons in the app bottom bar.
• Back Button — control back button in the app header.
• Settings Button — control settings button in the app context menu.
• Popup — show a native popup to a user.
• Loading Screen — customize loading screen of the app.

Device

Features related to device and operating system:

• Haptic — trigger vibrations to provide tactile user feedback.
• Biometrics — authenticate a user using biometric sensors.
• Geolocation — request and access user's location data.
• Motion Tracking — access device accelerometer, gyroscope, and orientation sensors.
• QR Scanner — scan QR codes using the device camera.
• File Downloads — download files to the user's device.
• Virtual Keyboard — control virtual on-screen keyboard.
• Clipboard — read text from the clipboard.
• Home Screen — add home screen shortcut to the app.
• Hardware Information — adjust app behavior based on device characteristics.

Telegram

Features specific to Telegram API:

• Payments — open native invoice popup right in the app.
• Permissions — request permissions to send messages or access phone number.
• Media Sharing — prompt a user to share prepared stories and messages.
• Data Sending — send custom data to the bot from the app.
• Inline Query — pre-fill inline query in any chat from the app.
• Emoji Status — control custom emoji status for the user.

Storage

Features for persisting data of the app:

• Cloud Storage — store app data on the Telegram servers.
• Device Storage — store app data on the user's device.
• Secure Storage — store sensitive app data on the user's device.