Skip to main content

Upgrading

Updating the Package​

composer update super-admin-org/super-admin

After updating, republish the assets:

php artisan vendor:publish --tag=super-admin-assets --force

Version Compatibility​

Super AdminLaravelPHPPest
1.2.x10.x / 11.x / 12.x / 13.x>= 8.22.x / 3.x / 4.x

Dev Dependency Matrix​

Due to transitive dependency constraints, the test runner version depends on your Laravel version:

LaravelPestPHPUnitnunomaduro/collision
10.x2.x10.x^7.0
11.x3.x11.x^8.0
12.x3.x / 4.x11.x / 12.x^8.0
13.x4.x12.x^8.9

Composer resolves the correct versions automatically.

Upgrading from Open-Admin or Laravel-Admin​

Super Admin is a fork of Open-Admin (itself a fork of Laravel-Admin). To migrate:

  1. Update your composer.json to use super-admin-org/super-admin
  2. Find and replace namespaces:
    • OpenAdmin\Admin to SuperAdmin\Admin
    • or Encore\Admin to SuperAdmin\Admin
  3. Republish assets and config
  4. Clear all caches
php artisan vendor:publish --provider="SuperAdmin\Admin\AdminServiceProvider" --force
php artisan config:clear
php artisan cache:clear
php artisan view:clear

Upgrading Laravel​

When upgrading your Laravel version, check the Laravel upgrade guide for breaking changes. Super Admin supports Laravel 10 through 13 simultaneously.