PHPackages                             vusys/tetryon - 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. [Testing & Quality](/categories/testing)
4. /
5. vusys/tetryon

ActiveLibrary[Testing & Quality](/categories/testing)

vusys/tetryon
=============

PHP-native browser testing for PHPUnit. Firefox-first, WebDriver BiDi, no Node, no Selenium, no ChromeDriver.

v0.1.0(1mo ago)021MITPHP ^8.4

Since Jun 21Compare

[ Source](https://github.com/Vusys/tetryon)[ Packagist](https://packagist.org/packages/vusys/tetryon)[ RSS](/packages/vusys-tetryon/feed)WikiDiscussions Synced 2w ago

READMEChangelog (1)Dependencies (8)Versions (7)Used By (0)

Tetryon
=======

[](#tetryon)

> PHPUnit. Firefox. WebDriver BiDi. Composer install. Useful errors. No faff.

**Tetryon** is a PHP-native browser testing package for PHPUnit. Write browser tests that are readable, reliable, and easy to run locally or in CI — without Node, Playwright, Selenium Server, ChromeDriver, or Dusk-style setup pain.

It is **Firefox-first** and **PHPUnit-first**. You run your app however you like; Tetryon drives the browser.

Note

**Status: 0.1.0 — beta, pre-1.0.** The API below ships and is exercised against real Firefox on Linux and macOS in CI — including a real Vue 3 single-page app — but it may still change before 1.0. See [compatibility](docs/compatibility.md).

The test you want to write
--------------------------

[](#the-test-you-want-to-write)

```
use Vusys\Tetryon\PHPUnit\BrowserTestCase;

final class LoginTest extends BrowserTestCase
{
    public function test_guest_can_log_in(): void
    {
        $this->browser()
            ->visit('/login')
            ->fill('Email', 'bryan@example.com')
            ->fill('Password', 'password')
            ->check('Remember me')
            ->press('Log in')
            ->assertSee('Dashboard');
    }
}
```

Run it through PHPUnit — Tetryon does not ship a competing test runner:

```
vendor/bin/phpunit --testsuite Browser
```

What works today
----------------

[](#what-works-today)

- **A fluent, readable API** — navigation, clicks, typing, forms, pointer and keyboard actions, and assertions, all driven by human labels rather than CSS.
- **A selector engine** — `'Email'` / `'Save changes'` resolve via test attributes → label → accessible name → placeholder → button/link text → name → id → visible text, with `@`/CSS/XPath escape hatches.
- **Auto-waiting** — every action waits for its target to be actionable; every assertion retries until timeout. Never a `sleep()`.
- **Failure diagnostics** — on failure, a screenshot, page HTML, console log, BiDi command trace, and browser stderr land in an artifact directory, with a readable report pointing at them.
- **`tetryon doctor`** — a preflight CLI that launches Firefox and checks the whole environment.
- **Natural-language steps** — `->step('I fill "Email" with "x"')` and `->scenario()->given()->when()->then()`, a deterministic layer over the same API.
- **First-class Laravel integration** — auto-discovered provider, `tetryon:install`, a self-booting `Laravel\BrowserTestCase` (factories + DB), and `loginAs()`.

It's proven against a real Vue 3 SPA — reactivity, async rendering, form validation, and client-side routing — with no manual waits.

A quick look
------------

[](#a-quick-look)

Selectors, auto-wait, and assertions:

```
$this->browser()
    ->visit('/settings')
    ->fill('Display name', 'Bryan')
    ->check('Email notifications')
    ->press('Save changes')
    ->assertSee('Saved');           // retries until it appears
```

Laravel, with a factory and login:

```
use App\Models\User;
use Vusys\Tetryon\Laravel\BrowserTestCase;

final class DashboardTest extends BrowserTestCase
{
    public function test_a_user_sees_their_dashboard(): void
    {
        $user = User::factory()->create();

        $this->loginAs($user)
            ->visit('/dashboard')
            ->assertSee('Welcome back');
    }
}
```

Natural language:

```
$this->scenario()
    ->given('I am on "/login"')
    ->when('I fill "Email" with "bryan@example.com"')
    ->and('I press "Log in"')
    ->then('I should see "Dashboard"');
```

Design pillars
--------------

[](#design-pillars)

- **PHPUnit only.** Supports PHPUnit 12 and 13. Normal PHPUnit tests — PHPUnit owns discovery, filtering, failures, grouping, exit codes, and CI behaviour.
- **Firefox first.** Firefox stable (and ESR where practical) on macOS and Linux. No Chrome/Edge/Safari/Windows/mobile in v1.
- **WebDriver BiDi.** Direct browser control with minimal moving parts. No Node, no Selenium Server, no ChromeDriver, no CDP as a core protocol.
- **Bring your own server.** Start your app with `php artisan serve`, `symfony serve`, `docker compose up`, `npm run dev`, whatever — point Tetryon at the base URL.
- **Auto-waiting by default.** You should rarely write a manual wait, never a `sleep()`.
- **Failure diagnostics as a feature.** Bad errors kill browser-testing adoption; good errors are the product.

Engineering standards
---------------------

[](#engineering-standards)

- **PHPStan level 9**, no baseline, no inline `@phpstan-ignore`.
- **Laravel Pint** for code style, **Rector** as a CI gate, **Infection**mutation testing.
- **CI** across PHP 8.4 / 8.5 and PHPUnit 12 / 13, plus a real-Firefox browser suite on **Linux and macOS**.
- **OpenSSF Scorecard**, Dependabot, and pinned-SHA GitHub Actions.

See [`CONTRIBUTING.md`](CONTRIBUTING.md) and [`CLAUDE.md`](CLAUDE.md).

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

[](#documentation)

Full docs live in [`docs/`](docs/README.md): [installation](docs/installation.md) · [writing tests](docs/writing-tests.md) · [selectors](docs/selectors.md) · [interactions](docs/interactions.md) · [natural language](docs/natural-language.md) · [waiting](docs/waiting.md) · [assertions](docs/assertions.md) · [configuration](docs/configuration.md) · [diagnostics](docs/diagnostics.md) · [Laravel](docs/laravel.md) · [CI](docs/ci.md) · [troubleshooting](docs/troubleshooting.md).

Roadmap
-------

[](#roadmap)

MilestoneStatusThemev0.1✓Firefox protocol spike — direct WebDriver BiDi controlv0.2✓PHPUnit alpha — fluent API, auto-wait, failure artifacts, `doctor`v0.3✓Natural-language stepsv0.4✓Laravel integration — provider, `tetryon:install`, `loginAs()`v0.5…CI hardening — GitHub Actions, GitLab, Docker, parallelismv0.6Stabilisation & docsLicense
-------

[](#license)

MIT — see [`LICENSE`](LICENSE).

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

45d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4213522?v=4)[Bryan](/maintainers/Vusys)[@Vusys](https://github.com/Vusys)

---

Tags

testingphpunitlaravelbrowser-testingwebdrivere2efirefoxend-to-endbidi

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/vusys-tetryon/health.svg)

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

###  Alternatives

[infection/infection

Infection is a Mutation Testing framework for PHP. The mutation adequacy score can be used to measure the effectiveness of a test set in terms of its ability to detect faults.

2.2k30.0M2.7k](/packages/infection-infection)[playwright-php/playwright

Modern PHP library for Playwright automation: browsing, scraping, screenshots, testing, and more.

20563.9k8](/packages/playwright-php-playwright)[hyvor/laravel-playwright

Laravel and Playwright E2E Testing

3423.9k](/packages/hyvor-laravel-playwright)

PHPackages © 2026

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