Skip to content

Running locally


Lightspeed is configured to automatically detect numerous CI platforms and split tests over multiple instances. However, this paradigm does not suite local developer machines.


Lightspeed is a drop in replacement for phpunit, pest, or paratest, even when running locally. all you need to do is execute vendor/bin/lightspeed.

TIP

If you are using Laravel and running your tests with php artisan test, you should continue using that command to ensure the framework is booted up correctly. Lightspeed is integrated into Laravel to execute the tests.


If the CI platform environment variables are not detected, Lightspeed operates in pass-through mode and runs all tests in the single invocation - no extra configuration necessary.


This is great for the tooling your project has set up to run in CI. It means you can use the same test scripts both locally and in CI and lightspeed will do the intelligent splitting based on the context.