Tandroid Documentation
The complete reference for a Telegram bot framework built around an Android-inspired architecture. This documentation is written Laravel-style: every chapter is self-contained, but the order below is the recommended learning path.
New here? Skip straight to the Complete Walkthrough Tutorial — a single, start-to- finish guide that takes you from an empty folder to a working bot with two Activities, navigation, persisted state, and both run modes (polling and webhook) tested locally. Every other chapter below explains one concept from that tutorial in depth.
Getting Started
Core Architecture
- The Kernel and the Boot Lifecycle
- Activities and Intents
- Views and Widgets
- ViewModel and State Management
Data and Infrastructure
Extensibility
Connecting to Telegram
Other Features
- Localization (i18n)
- Testing
- Deployment: Shared Hosting and VPS
- Advanced Features: Remote Intents, Guest Mode, Managed Bots
Quick Reference
| Android concept | Aicrion\Tandroid equivalent | Docs |
|---|---|---|
Activity |
Activity\BotActivity |
Activities and Intents |
Intent / IntentFilter |
Intent\Intent / Attribute\IntentFilter |
Activities and Intents |
ActivityManagerService |
Kernel\ActivityManager |
The Kernel |
PackageManagerService |
Package\PackageManager |
Plugins |
AndroidManifest.xml |
each plugin's Package\Manifest |
Plugins |
View / Widget |
View\View / Widget\* |
Views and Widgets |
androidx.lifecycle.ViewModel |
Kernel\ViewModel\ViewModel |
ViewModel |
BroadcastReceiver |
Attribute\BroadcastFilter |
Broadcasts |
| Back Stack | Kernel\BackStackStore |
The Kernel |
| Navigation Deep Links | Kernel\DeepLinkResolver |
Activities and Intents |
Found a bug?
If the framework's actual behavior doesn't match what's written here,
treat it as a bug — this documentation is meant to always be an
accurate reflection of the real code in src/, not architectural
aspirations.