next-associates/next-dashboard-package

Next Dashboard Api as package

dev-main 2025-06-29 07:21 UTC

Requires

• php: ^8.1
• illuminate/auth: ^10.0 || ^11.0 || ^12.0
• illuminate/database: ^10.0 || ^11.0 || ^12.0
• illuminate/http: ^10.0 || ^11.0 || ^12.0
• illuminate/routing: ^10.0 || ^11.0 || ^12.0
• illuminate/support: ^10.0 || ^11.0 || ^12.0
• illuminate/validation: ^10.0 || ^11.0 || ^12.0
• spatie/laravel-activitylog: ^4.10
• spatie/laravel-medialibrary: ^11.5
• spatie/laravel-permission: ^6.0
• spatie/laravel-translatable: ^6.11

MIT

• Next-Associates

README

NextDashboard is a customizable admin dashboard package built specifically for Laravel projects.
It provides out-of-the-box features including:

• Admin authentication system
• Role & permission management using Spatie Laravel-Permission
• A full-featured ticketing system
• Media management and activity logging via Spatie libraries

📦 Installation & Setup

1️⃣ Install the Package

composer require nagahnextdev/nextdashboard:dev-main

🔐 Authentication Setup

Update your config/auth.php file:

➕ Add the admin guard:

'admin' => [
    'driver' => 'token',
    'provider' => 'admins',
],

➕ Add the admins provider:

'admins' => [
    'driver' => 'eloquent',
    'model' => \nextdev\nextdashboard\Models\Admin::class,
],

🛡️ Spatie Permission Setup

php artisan vendor:publish --tag="permission-migrations"
php artisan vendor:publish --tag="permission-config"
php artisan migrate

📁 Media Library Setup

php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-migrations"
php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-config"

Update your config/filesystems.php:

'disks' => [
    'public' => [
        'driver' => 'local',
        'root' => storage_path('app/public'),
        'url' => env('APP_URL').'/storage',
        'visibility' => 'public',
    ],
]

Then link the storage:

php artisan storage:link

📝 Activity Log Setup

php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="activitylog-migrations"
php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="activitylog-config"
php artisan migrate

⚙️ Publish NextDashboard Resources

php artisan vendor:publish --tag=nextdashboard-migrations
php artisan vendor:publish --tag=nextdashboard-seeders

🌱 Seed Initial Admin User

php artisan db:seed --class=PermissionSeeder
php artisan db:seed --class=AdminSeeder

Note: Ensure that Spatie permissions are properly installed before running this seeder.

📢 Available Events

You can list all available events using:

php artisan nextdashboard:list-events

Event Name	Description
AdminCreated	Triggered when a new admin is created
RoleAssignedToAdmin	Triggered when a role is assigned to an admin
TicketCreated	Triggered when a new ticket is created
TicketAssigned	Triggered when a ticket is assigned to an admin
TicketReplied	Triggered when a reply is added to a ticket

🧹 Scheduled Commands

Clean up expired OTPs:

php artisan otps:delete-expired

Add this command to the scheduler in your App\Console\Kernel.php.