v0.1.0

First tagged release of Tetryon — PHP-native browser testing for PHPUnit, Firefox-first over WebDriver BiDi. No Node, Selenium, ChromeDriver, or Dusk-style setup.

Beta, pre-1.0. The public API may still change before 1.0 — see compatibility.

Install

composer require --dev vusys/tetryon
vendor/bin/tetryon doctor

Highlights

• Fluent, readable API — navigation, clicks, typing, forms, pointer/keyboard actions, and assertions, driven by human labels rather than CSS.
• Selector engine — resolves a label through test attributes → label → accessible name → placeholder → button/link text → name → id → visible text, with @/CSS/XPath escape hatches, and within() scoping.
• Auto-waiting — every action waits for its target to be actionable; every assertion retries until timeout. Never a sleep().
• Failure diagnostics — screenshot, page HTML, console log, BiDi command trace, and browser stderr captured to an artifact directory on failure.
• tetryon doctor — a preflight CLI that launches Firefox and checks the environment.
• Natural-language steps — ->step(...) and ->scenario()->given()->when()->then(), deterministic, no .feature files.
• First-class Laravel integration — auto-discovered provider, tetryon:install, a self-booting Laravel\BrowserTestCase (factories + DB), and loginAs().

Supported

PHP 8.4 / 8.5 · PHPUnit 12 / 13 · Firefox on Linux and macOS. Exercised against real Firefox on both platforms in CI, including a real Vue 3 single-page app.

See the documentation and the changelog.