Install
Install the package and boot the Kernel in your entry point.
composer require aicrion/tandroidQuick Start
Send a message
A fluent facade for every Bot API method.
Telegram::message()
->to($chatId)
->text('Hello from Aicrion')
->send();Core Architecture
Kernel
Boots the Container, discovers plugins, runs automatic migrations, connects Telegram, and routes Updates.
Activity
A screen-like unit of interaction, with onCreate/onResume/onPause and NavigationRequest chaining.
ViewModel
Holds structured state across multiple Activities, persisted in the StateStore (cache).
API Reference (Summary)
| Area | Sample methods | Use case |
|---|---|---|
| Messaging | message, edit, message_ (forward/copy) | Core conversation flow |
| Media | photo, video, document, mediaGroup | Sending rich content |
| Administration | chat, inviteLinks, forum | Group/channel management |
| Payments | invoice, preCheckout, starTransactions | Selling digital goods |
| Inline | inline, webApp, guestQuery | Cross-chat interactions |
The complete, exact table is in the full Telegram API reference.
Widgets
FormWidget
A linear multi-step form with validation and state recovery.
WizardWidget
Multiple pages with explicit Previous/Next buttons.
RichMessage
Tables, quotes, code blocks, maps, and slideshows.
CheckboxGroupWidget
A multi-select checkbox group, stateless between taps.
Full details in Views and Widgets.
Testing
Unit tests cover Intent, Translator, ViewModel, and ActivityManager's navigation chain, plus an overall project health smoke test.
vendor/bin/phpunitFull testing guide in Testing.
Deployment
A step-by-step guide for deploying to shared hosting (no CLI) and VPS/Docker is in Deployment.