by DCzajkowski

DCzajkowski / auth-tests

Always-current tests for Laravel's authentication system. Curated by the community.

222 Stars 25 Forks Last release: about 1 month ago (8.0.0) MIT License 89 Commits 34 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Missing tests for Laravel's auth module

Latest Stable Version License MIT PRs Welcome

⚠️ Deprecation notice ⚠️

As of Laravel 8, the laravel/ui package is discouraged to be used on new Laravel installations. This package should be used only with already-existing, created with Laravel 7 or lower, applications that use laravel/ui auth controllers.

All of the applications already using laravel/ui will get updates of this package to new Laravel versions, although the support may be dropped in the future. This doesn't mean you won't be able to use the package or upgrade to new Laravel versions, but that the upgrades to the major versions may require manual changes from the consumers of this package.

The new way of installing Laravel 8's and above auth scaffolding is using the

option in the Laravel installer. Laravel Jetstream hides all of its controllers inside the package, meaning it doesn't make sense to test those controllers, as they are already tested inside the package.


~The version of this package reflects current major version of the Laravel framework. For example: If Laravel framework has version 5.6, version of this package compatible will be


Due to changes in Laravel's versioning scheme, version 6.1.* will aim to be compatible with a version 6.1.* of Laravel. For example, auth-tests version 6.1.1 and 6.1.20 will be all compatible with Laravel 6.1.*


Before installation please make sure you have scaffolded frontend views with a

flag e.g.
composer require laravel/ui && php artisan ui vue --auth
composer require dczajkowski/auth-tests --dev
php artisan make:auth-tests --without-email-verification


file by adding these two lines between

Alternatively, use different database than sqlite, but also different from the one used for development.

Using the e-mail verification feature

If you want to use the e-mail verification feature, you will have to make following changes: - update

- Auth::routes();
+ Auth::routes(['verify' => true]);
- update
- class User extends Authenticatable
+ class User extends Authenticatable implements MustVerifyEmail


There are four flags for customizing your tests. You can use any combination of them. (All flags have their short version e.g.

) ```php


public function testUserCanLogout() { // }

make:auth-tests --snake-case

public function testusercan_logout() { // }

make:auth-tests --annotation

/** @test */ public function userCanLogout() { // }

make:auth-tests --public

function testUserCanLogout() { // }

make:auth-tests --curly

public function testUserCanLogout() { // }

make:auth-tests -caps # or --zonda

/** @test */ function usercanlogout() { // } ``

Since version 5.7 there has been a new test for email verification added. You can omit it by running

To review all flags run

php artisan make:auth-tests --help


To update tests when a new version of this package arrives:

composer update dczajkowski/auth-tests
php artisan make:auth-tests
Warning! All changes to the files this package provides will be lost when running this command!

Automate your workflow

Instead of including this package manually every project you create, simply create a bash function that will do that for you. I have included my personal function here. Feel free to edit it and reuse however you like.


Feel free to make PRs to this repo.


This package is open-source software licensed under the MIT license (same as Laravel itself).

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.