README

super-admin is administrative interface builder for laravel which can help you build CRUD backends just with few lines of code.

Homepage | Documentation | Download | Extensions

Forked from Laravel-admin Much thanks to Z-song for all the effort & great setup!

This project is forked from open-admin, itself a fork of Laravel-admin. Because both projects are no longer updated and remain incompatible with Laravel 11 and 12, this repository continues the work to support these newer versions.

Requirements

PHP >= 8.2.0
Laravel >= 12.0.0
Fileinfo PHP Extension

Installation

This package requires PHP 8.2+ and Laravel 12.0 or up

First, install laravel (12.0 or up), and make sure that the database connection settings are correct.

composer require super-admin-org/super-admin

Then run these commands to publish assets and config：

php artisan vendor:publish --provider="SuperAdmin\Admin\AdminServiceProvider"

After run command you can find config file in config/admin.php, in this file you can change the install directory,db connection or table names.

At last run following command to finish install.

php artisan admin:install

Open http://localhost/admin/ in browser,use username admin and password admin to login.

Updating

Updating to a new version of super-admin may require updating assets you can publish them using:

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

Configurations

The file config/admin.php contains an array of configurations, you can find the default configurations in there.

Running Tests

Install the PHP dependencies using Composer:
```
composer install
```
Copy the provided SQLite environment file to .env and to the test application shipped in vendor/laravel/laravel:
```
cp .env.test.sqlite .env
cp .env.test.sqlite vendor/laravel/laravel/.env
```
If you prefer, adjust the test bootstrap so that it loads the file directly from the repository root instead of copying it.
Optionally generate a fresh application key (not required when using the provided .env.test.sqlite):
```
php vendor/laravel/laravel/artisan key:generate
```
Run the tests with Pest:
```
vendor/bin/pest
```

Extensions

Extension development

More coming soon

Extension	Description	super-admin
helpers	Several tools to help you in development	~1.0
media-manager	Provides a web interface to manage local files	~1.0
config	Config manager for super-admin	~1.0
grid-sortable	Sortable grids	~1.0
CkEditor	CkEditor for forms	~1.0
api-tester	Test api calls from the admin	~1.0
scheduling	Show and test your cronjobs	~1.0
phpinfo	Show php info in the admin	~1.0
log-viewer	Log viewer for Laravel	~1.0.12
page-designer	Page designer to position items freely	~1.0.18
reporter	Provides a developer-friendly web interface to view the exception	~1.0.18
redis-manager	Redis manager for super-admin	~1.0.20

Contribute?

we are looking for active contributors:

testing
extension development
translating documentation
financing

Other

super-admin based on the following plugins or services:

License

super-admin is licensed under The MIT License (MIT).

super-admin-org / super-admin

Maintainers

Details