Skip to content

Introduction

Packages Toolkit for Laravel is a collection of packages that have been designed to write, test, and preview your Laravel packages.

Before going through the rest of this documentation, please take some time to read the Package Development section of Laravel's own documentation, if you haven't done so yet.

Installation

To start using Packages Toolkit for Laravel you can first install the components:

bash
composer require --dev "orchestra/testbench"

Alternatively, if you need to run Dusk tests on your Laravel package you should install the following dependency instead:

bash
composer require --dev "orchestra/testbench-dusk"

Setup

Next, you can run the following command to scaffold your package with the recommended setup:

bash
vendor/bin/testbench workbench:install

Components

Testbench

Testbench simplifies the process to create feature and integration tests for your Laravel packages without massive configuration and build steps.

Version Compatibility
LaravelTestbenchRecommended Versions
8.x6.x^6.45
9.x7.x^7.44
10.x8.x^8.25
11.x9.x^9.3

Testbench Dusk

Testbench Dusk is built on top of Testbench to provide support running browser-based tests for your Laravel packages using Laravel Dusk.

Version Compatibility
LaravelTestbench DuskRecommended Versions
8.x6.x^6.50
9.x7.x^7.46
10.x8.x^8.28
11.x9.x^9.6

Testbench Core

Testbench Core provides the full testing API and CLI testbench binary which is being used by Testbench, Testbench Dusk, and Workbench. This component is accessible via orchestra/testbench without any further requirements.

Version Compatibility
LaravelTestbench Core
8.x6.x
9.x7.x
10.x8.x
11.x9.x

Canvas

Canvas replicates all of the make artisan commands available in your basic Laravel application to speed up your Laravel package development.

Version Compatibility
LaravelCanvasRecommended Versions
8.x6.x^6.10
9.x7.x^7.11
10.x8.x^8.11
11.x9.x^9.1

Workbench

Workbench provides a set of configurable actions and commands to allow previewing, interacting, and serving your Laravel packages during development. This component is accessible via orchestra/testbench without any further requirements.

Version Compatibility
LaravelWorkbenchRecommended Versions
8.x--
9.x7.x^7.9
10.x8.x^8.9
11.x9.x^9.5