README

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

Homepage | Documentation | GitHub | Extensions

Forked from Laravel-admin & Open-admin. Much thanks to Z-song and the open-admin team for their effort and great setup!

Both upstream projects are no longer maintained and remain incompatible with Laravel 11+. This repository continues the work to support Laravel 10, 11, 12, and 13.

Compatibility

Laravel	PHP	Status
13.x	8.3, 8.4	Supported
12.x	8.2, 8.3, 8.4	Supported
11.x	8.2, 8.3, 8.4	Supported
10.x	8.2, 8.3	Supported

Features

Model Grid - Data tables with sorting, filtering, inline editing, export, and batch actions
Model Form - 60+ field types, validation, tabs, file uploads, and relationship management
Model Show - Detail pages with panels and relation display
Model Tree - Hierarchical/nested data with drag-and-drop ordering
RBAC - Built-in users, roles, and permissions management
Operation Log - Audit trail for all admin actions
Menu Management - Sidebar menu with drag-and-drop ordering
Widgets - Box, Tab, Table, InfoBox, Collapse, Alert, Carousel, and more
Extension System - 12+ official plugins available
19 Artisan Commands - Scaffolding, user management, and code generation
Responsive UI - Built on Bootstrap 5

Installation

Requires PHP 8.2+ and Laravel 10.0 or higher.

composer require super-admin-org/super-admin

Publish assets and config:

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

After running the command you can find the config file in config/admin.php, where you can change the install directory, database connection, or table names.

Run the installer:

php artisan admin:install

Open http://localhost/admin/ in your browser. Login with username admin and password admin.

Updating

composer update super-admin-org/super-admin
php artisan vendor:publish --tag=super-admin-assets --force

Quick Start

# 1. Create a model
php artisan make:model Post -m

# 2. Generate an admin controller
php artisan admin:controller \\App\\Models\\Post

# 3. Add route in app/Admin/routes.php
#    $router->resource('posts', PostController::class);

# 4. Add menu item at /admin/auth/menu with URI "posts"

That's it! Full CRUD interface with grid, form, filters, and detail page.

Documentation

Comprehensive documentation is available in the docs/ directory with 28 pages covering every feature of the package.

Getting Started

Page	Description
Installation	Step-by-step setup, database tables, troubleshooting
Quick Start	Build your first CRUD in 5 minutes with scaffolding
Configuration	Complete config reference - auth, upload, layout, map, and more
Upgrading	Version upgrades, migration from open-admin/laravel-admin

Model Grid (Data Tables)

Page	Description
Basic Usage	Create grids, add columns, query data, pagination, relationships
Column Usage	Width, color, sorting, help text, hide, string/collection operations
Column Display	20+ display formatters: image, label, badge, bool, progress, link, QR code, copyable, secret, modal, expand
Filters	17 filter types (equal, like, between, gt/lt, date, where...) with select, radio, checkbox, datetime presenters
Inline Editing	Edit data directly in the grid: editable text, switch, select, radio, checkbox
Row & Batch Actions	Custom row actions, batch operations, dropdown/context menu styles
Data Export	CSV/Excel export, custom exporters
Grid Tools	Header, footer, total row, quick search, quick create, hot keys, column selector

Model Form (Data Entry)

Page	Description
Basic Usage	Create forms, tools, footer, ignore fields, detect state
Form Fields	60+ field types: text, select, radio, checkbox, date/time, file, image, editor, tags, color, map, key-value, table, switch, belongs-to, has-many, embeds, and more
Validation	Laravel validation rules, custom messages, creation/update rules, unique constraints
Image/File Upload	Storage config, thumbnails, naming, cloud storage, multiple files
Callbacks	Hooks: saving, saved, deleting, deleted, editing, submitted
Layout	Tabs, columns, rows, fieldsets, dividers, cascade groups, step forms

Model Show & Tree

Page	Description
Model Show	Detail pages with panels, formatting, relations (one-to-one, one-to-many, many-to-many)
Model Tree	Hierarchical data with ModelTree trait, drag-and-drop ordering, select options

Admin Features

Page	Description
Permissions	RBAC system: users, roles, permissions, route binding, middleware, operation log
Widgets	Box, InfoBox, Tab, Table, Collapse, Alert, Callout, Carousel, Form widget, page layout
Console Commands	19 Artisan commands: install, generate controller/form/action, create user, reset password, export seed
CSS/JavaScript	Custom assets, inline scripts, theming, built-in libraries
Extensions	Build and install extensions, official plugin list

Verification

Page	Description
Test Coverage Map	Every documented feature mapped to automated tests proving it works

Extensions

Extension	Description	Version
helpers	Several tools to help you in development	~1.0
media-manager	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 cron jobs	~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	Developer-friendly exception viewer	~1.0.18
redis-manager	Redis manager for super-admin	~1.0.20

Contributing

We are looking for active contributors:

Testing
Extension development
Translating documentation
Financing

Built With

License

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

super-admin-org / super-admin

Maintainers

Package info

Fund package maintenance!

Statistics

Security