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+. Super Admin 2.x supports Laravel 8 through 13 on PHP 8.0+.
| 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 |
| 9.x | 8.0, 8.1, 8.2 | Supported (end-of-life framework, see note) |
| 8.x | 8.0, 8.1 | Supported (end-of-life framework, see note) |
- 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
- Two-Factor Login - Authenticator-app codes and recovery codes; off, optional or required for everyone
- Operation Log - Audit trail for all admin actions
- Menu Management - Sidebar menu with drag-and-drop ordering
- Templates - Tailwind Light (default) and Bootstrap Classic, switchable from Admin > Templates
- Widgets - Box, Tab, Table, InfoBox, Collapse, Alert, Carousel, and more
- Extension System - 12 official extensions that follow the active template
- 23 Artisan Commands - Scaffolding, user management, code generation, and
admin:upgradeto finish updates
Requires PHP 8.0+ and Laravel 8.0 or higher. Laravel 8 and 9 are end-of-life and ship with published security advisories; Composer 2.8+ refuses to install them unless
audit.block-insecureis set tofalse. Use them only for existing applications you cannot upgrade yet.
composer require super-admin-org/super-adminPublish 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:installOpen http://localhost/admin/ in your browser. Login with username admin and password admin.
composer update super-admin-org/super-admin
php artisan vendor:publish --tag=super-admin-assets --force# 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.
Full documentation, in English and Bangla, is at super-admin.org. The same pages are in the docs/ directory of this repository.
After composer update, finish an update with:
php artisan admin:upgradeIt publishes the new assets, runs new migrations and clears compiled views. See Upgrading.
| 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 |
| 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 |
| 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 |
| 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 |
| 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 | 23 Artisan commands: install, upgrade, generate controller/form/action, create user, reset password, two-factor, templates, export seed |
| CSS/JavaScript | Custom assets, inline scripts, theming, built-in libraries |
| Extensions | Build and install extensions, official plugin list |
| Page | Description |
|---|---|
| Test Coverage Map | Every documented feature mapped to automated tests proving it works |
All extensions work with Super Admin 1.x and 2.x. Install with composer require super-admin-org/<name>.
| Extension | Description | Docs |
|---|---|---|
| helpers | Several tools to help you in development | Guide |
| media-manager | Web interface to manage local files | Guide |
| config | Config manager for super-admin | Guide |
| grid-sortable | Sortable grids | Guide |
| CkEditor | CkEditor for forms | Guide |
| api-tester | Test API calls from the admin | Guide |
| scheduling | Show and test your cron jobs | Guide |
| phpinfo | Show PHP info in the admin | Guide |
| log-viewer | Log viewer for Laravel | Guide |
| page-designer | Page designer to position items freely | Guide |
| reporter | Developer-friendly exception viewer | Guide |
| redis-manager | Redis manager for super-admin | Guide |
We are looking for active contributors:
- Testing
- Extension development
- Translating documentation
- Financing
- Laravel - Bootstrap 5
- Axios - Font Awesome
- Choicesjs - Flatpickr
- Sweetalert2 - Toastify
- Sortablejs - Nprogress
- LeafletJS / OpenStreetMaps
- Dual-Listbox - Coloris
super-admin is licensed under The MIT License (MIT).