PHPackages                             aicrion/tandroid - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. aicrion/tandroid

ActiveLibrary

aicrion/tandroid
================

Android-inspired OS-like framework for building Telegram bots in PHP 8.5+

17PHPCI failing

Since Jul 13Pushed 1mo agoCompare

[ Source](https://github.com/Aicrion/tandroid)[ Packagist](https://packagist.org/packages/aicrion/tandroid)[ RSS](/packages/aicrion-tandroid/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

 [![Tandroid logo](docs/assets/logo.png)](docs/assets/logo.png)

Tandroid
========

[](#tandroid)

 **An Android-inspired framework for building Telegram bots in PHP.**

 [![PHP Version](https://camo.githubusercontent.com/b719098f6822b3d5de8b35671fbdb321acb3cccdf7de5a69073aa7965deeaf3f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e352d373737626234)](https://packagist.org/packages/aicrion/tandroid) [![License](https://camo.githubusercontent.com/b8cadaa967891081f8f165695470689986c028821dd8a040132f6e661795dc0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c7565)](LICENSE) [![Tests](https://camo.githubusercontent.com/d940ad7f0752e2cbe0d63c50dcebf329078807390051c41fe63258f1b5c4e182/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f74657374732d70617373696e672d627269676874677265656e)](https://github.com/aicrion/tandroid/actions) [![Docs](https://camo.githubusercontent.com/f33b749d0101e587df9547755e4e9e4e3a8ecc2176d9ba8b9e18cdd7d444093b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d6f6e6c696e652d303136393666)](https://aicrion.github.io/tandroid)

Tandroid brings Android's application model to Telegram bot development. Every feature is an **Activity**, navigation between features is an **Intent**, every installable feature is a **plugin**with its own manifest, and state survives across requests via a **ViewModel** — concepts you already know, applied to a domain where they've never quite existed before.

Built on Symfony (DI, Cache, HTTP Client) and Doctrine ORM, Tandroid runs equally well on a $3/month shared host or a Dockerized VPS — migrations and plugin discovery happen automatically, with zero CLI commands required in production.

Why Tandroid
------------

[](#why-tandroid)

- **A real application model, not a router.** Activities have a lifecycle (`onCreate`, `onResume`, `onPause`, `onDestroy`), a back stack, and explicit/implicit Intent resolution — the same mental model as native Android apps.
- **Plugins, not spaghetti.** Every feature lives in its own `plugins//` folder with an isolated manifest, entities, and migrations — install, remove, or share a feature without touching the rest of the bot.
- **Stateful conversations, done right.** `ViewModel` + `StateStore`persist structured state between Activities and requests, so multi-step flows (forms, wizards, checkouts) stay simple.
- **Zero-ops deployment.** Migrations run automatically on boot. Redis is optional — the cache layer falls back to the filesystem transparently, so shared hosting just works.
- **Full Telegram Bot API coverage.** Messaging, media, payments & Stars, inline mode, forums, business accounts, gifts, and more — behind one fluent facade.

Quick Start
-----------

[](#quick-start)

```
composer require aicrion/tandroid
```

```
use Aicrion\Tandroid\Activity\{BotActivity, NavigationRequest};
use Aicrion\Tandroid\Attribute\IntentFilter;
use Aicrion\Tandroid\Intent\Intent;
use Aicrion\Tandroid\View\View;

#[IntentFilter(action: 'MAIN', category: 'LAUNCHER')]
final class StartActivity extends BotActivity
{
    public function onCreate(Intent $intent): ?NavigationRequest
    {
        $this->setContentView(View::message('Welcome 👋'));

        return null;
    }
}
```

```
use Aicrion\Tandroid\Kernel\Kernel;

$kernel = Kernel::fromConfigFile(__DIR__ . '/config/aicrion.yaml')->boot();
$kernel->handle($update); // resolves the Activity and sends the reply
```

Documentation
-------------

[](#documentation)

Full documentation — installation, architecture, Activities & Intents, Views & Widgets, ViewModels, database, caching, plugins, broadcasts, deployment, and the complete API reference — is available at:

**[aicrion.github.io/tandroid](https://aicrion.github.io/tandroid)**

New to Tandroid? Start with the [complete walkthrough tutorial](https://aicrion.github.io/tandroid/guide/tutorial.html) — it takes you from an empty folder to a working bot with navigation, persisted state, and both run modes tested locally.

Testing
-------

[](#testing)

```
composer test
```

Contributing
------------

[](#contributing)

Issues and pull requests are welcome. Please open an issue first for significant changes, and make sure `composer test` passes before submitting a PR.

License
-------

[](#license)

Tandroid is open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

21

—

LowBetter than 17% of packages

Maintenance60

Regular maintenance activity

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12207627?v=4)[Hadi Akbarzadeh](/maintainers/nabeghe)[@nabeghe](https://github.com/nabeghe)

---

Top Contributors

[![nabeghe](https://avatars.githubusercontent.com/u/12207627?v=4)](https://github.com/nabeghe "nabeghe (23 commits)")

### Embed Badge

![Health badge](/badges/aicrion-tandroid/health.svg)

```
[![Health](https://phpackages.com/badges/aicrion-tandroid/health.svg)](https://phpackages.com/packages/aicrion-tandroid)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)