jeffersongoncalves / laravel-user

1.0.1 2026-09-26 20:52 UTC

Requires

• php: ^8.2
• laravel/framework: ^12.61.1|^13.12.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.24
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0

MIT

• Jefferson Gonçalves

• Authentication
• user
• Users
• laravel
• starter-kit

Published on Packagist.org on 2026-09-26 20:53 UTC

README

Laravel User

Base authenticatable User model, migration, factory and observer shared by the jeffersongoncalves Laravel starter kits.

Your app keeps its own App\Models\User and simply extends the package model, so columns, casts, factory and observer live in one place and every kit gets fixes through composer update.

Installation

composer require jeffersongoncalves/laravel-user

Publish and run the migration (skip it if your app already has a users table with the same columns):

php artisan vendor:publish --tag="laravel-user-migrations"
php artisan migrate

Usage

namespace App\Models;

use JeffersonGoncalves\User\Models\User as BaseUser;

class User extends BaseUser
{
    // add traits, relations or overrides here
}

config/auth.php keeps pointing the users provider to App\Models\User.

What the base model gives you:

Feature	Details
Columns	status, name, email, email_verified_at, password, remember_token, avatar_url, custom_fields, locale, theme_color
Casts	password hashed, status boolean, custom_fields array, email_verified_at datetime
Contracts	Authenticatable, Authorizable, CanResetPassword, MustVerifyEmail, Notifiable
Factory	User::factory() with unverified() and inactive() states. It creates the model set in auth.providers.users.model, so App\Models\User::factory() works without a factory in your app
Observer	Clears the users_count cache key on create/delete (inherited by subclasses)

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• Jefferson Gonçalves
• All Contributors

License

The MIT License (MIT). Please see License File for more information.