bangjhon/laravel-pro-starter

A premium Laravel starter package with custom authentication, role-based dashboards, and modern Tailwind-powered UI.

v1.1.0 2026-04-23 06:05 UTC

Requires

• php: ^8.1
• laravel/framework: ^10.0|^11.0|^12.0|^13.0

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pint: ^1.17
• mockery/mockery: ^1.6
• nunomaduro/collision: ^7.0|^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.5|^11.5|^12.0

MIT

• package
• Authentication
• laravel
• dashboard
• starter
• tailwind

README

bangjhon/laravel-pro-starter is a production-ready Laravel package that adds a custom authentication system, role-aware dashboards, and a premium modern UI to any Laravel 10+ application.

Features

• Custom authentication flow built with Laravel controllers and middleware
• Registration, login, logout, remember me, and role-based redirects
• admin and user roles out of the box
• Premium dashboard UI with sidebar, topbar, stat cards, tables, and responsive auth screens
• Publishable config, views, and assets
• Install command that publishes package resources, runs migrations, and seeds a default admin user
• Extendable activity log table for dashboard metrics

Requirements

• PHP 8.1+
• Laravel 10, 11, 12, or 13

Installation

Install the package via Composer:

composer require bangjhon/laravel-pro-starter

Run the installer:

php artisan bangjhon:install

The installer will:

• publish configuration
• publish Blade views
• publish assets
• run package migrations
• seed a default admin account
• print the generated credentials and next steps

Default Routes

The package registers the following routes by default:

• /login
• /register
• /logout
• /dashboard
• /admin/dashboard
• /admin/users

All route names are prefixed with bangjhon..

Default Admin Credentials

These values come from config/bangjhon-pro-starter.php and can be changed before running the installer.

• Email: [e-mail]
• Password: password123

Usage

After installation:

1. Visit /register to create a standard user account.
2. Visit /login to sign in.
3. Users are redirected to /dashboard.
4. Admins are redirected to /admin/dashboard.

Use the included role middleware on your own routes:

Route::middleware(['web', 'auth', 'bangjhon.role:admin'])->group(function () {
    Route::get('/reports', fn () => 'Only admins can see this');
});

Configuration

Publish the package configuration manually if needed:

php artisan vendor:publish --tag=bangjhon-pro-starter-config

Useful options:

• route prefix
• route middleware stack
• registration toggle
• branding labels
• seeded admin credentials

Published Resources

php artisan vendor:publish --tag=bangjhon-pro-starter-config
php artisan vendor:publish --tag=bangjhon-pro-starter-views
php artisan vendor:publish --tag=bangjhon-pro-starter-assets

Screenshots

• Auth screen placeholder: docs/screenshots/login.png
• Admin dashboard placeholder: docs/screenshots/admin-dashboard.png
• User dashboard placeholder: docs/screenshots/user-dashboard.png

Example Commands

php artisan bangjhon:install
php artisan migrate
php artisan vendor:publish --tag=bangjhon-pro-starter-views
php artisan route:list --name=bangjhon

Extending The Package

• Update the published views to match your brand.
• Extend the bangjhon_activity_logs table with your own event metadata.
• Reuse the package middleware and layout structure for additional admin pages.

Testing

composer test

Preview

License

MIT