Install

Install Canio from Packagist.

composer require oxhq/canio
php artisan canio:install

The install command publishes config, downloads the matching Stagehand binary, verifies checksums, installs a Chrome for Testing browser bundle for local renderers, and runs a local doctor check.

First render

use Oxhq\Canio\Facades\Canio;

return Canio::view('pdf.invoice', ['invoice' => $invoice])
    ->profile('invoice')
    ->title('Invoice #123')
    ->stream('invoice.pdf');

What happens by default

• Canio runs in embedded mode unless you configure otherwise.
• Stagehand uses the Rod-backed rod-cdp renderer by default.
• The browser bundle defaults to full Chrome for Testing chrome.
• The package auto-starts the local runtime on first render when needed.
• The Laravel-facing API stays native: view(), html(), and url().

Browser bundle commands

php artisan canio:browser:install
php artisan canio:browser:repair
php artisan canio:doctor

Use CANIO_RENDERER_DRIVER=local-cdp to fall back to direct CDP, or CANIO_RENDERER_DRIVER=remote-cdp when Chrome runs outside the Laravel host.

Next steps

• Read the v1.0.6 release notes.
• Read the deployment guide before production rollout.
• Check the full package README for commands and operations.