History and architecture
Super Admin continues a line of Laravel admin builders that started in 2016.
| When | What | Notes |
|---|---|---|
| 2016–2021 | laravel-admin by z-song | The original builder: Grid, Form, Show, Tree, RBAC, extensions. Built on AdminLTE / Bootstrap 3 and jQuery. Development stopped around Laravel 9. |
| 2021–2023 | open-admin (open-admin-org) | A fork that removed jQuery and AdminLTE, rebuilt the front end on Bootstrap 5 with plain JavaScript and PJAX page loads, kept the PHP API. Stopped before Laravel 11. |
| May 2025 | super-admin forked | New repository super-admin-org/super-admin by Talemul Islam. Goal: keep the laravel-admin / open-admin API working on current Laravel and PHP. First commits 24–25 May 2025. |
| Jun 2025 | v1.0.0, v1.1.0 | Laravel 10/11/12 support, PHP 8.2+, Pest test suite, GitHub Actions matrix. |
| Aug 2025 | v1.1.2 – v1.1.6 | First public release on Packagist (changelog entry 11 Aug 2025), documentation set (28 pages), 23 translations. |
| Sep 2025 | v1.1.7 – v1.1.10 | Laravel 13 support, bug fixes, code-style automation. |
| Mar 2026 | v1.2.0, v1.2.1 | Last release on the single Bootstrap template. |
| Mar–Oct 2026 | template branch | Template system: views can live in resources/views/<template>/ with fallback to the root views; new Tailwind Light template (Tailwind CSS 3.4, Vite build, no Bootstrap JS); the old views kept as super-admin-template-1. 32 commits. |
| Oct 2026 | v1.3.0 | Template release. 24 bugs fixed (see section 13), the test suite runs to completion again (819 tests), this manual. |
What is in the repository
src/ PHP source (~39,000 lines)
Admin.php Service: builders, menu, user, navbar, assets, routes
AdminServiceProvider Registers views (template aware), middleware, commands, publishing
Grid.php, Grid/ Data tables: 35 column displayers, 21 filter types, exporters, tools
Form.php, Form/ Forms: 59 field types, tabs/rows, uploads, nested forms, cascades
Show.php, Show/ Detail pages: fields, panels, relations
Tree.php, Tree/ Nested, drag-and-drop lists
Actions/ Row, batch and standalone actions with toast / dialog responses
Auth/ Administrator, Role, Permission, Menu, OperationLog models; RBAC checks
Controllers/ Built-in pages (users, roles, permissions, menu, logs, auth, dashboard)
Middleware/ admin.auth, admin.permission, admin.log, admin.pjax, admin.bootstrap, admin.throttle
Widgets/ Box, InfoBox, Tab, Table, Alert, Callout, Collapse, Carousel, Form, StepForm, Navbar
Console/ 19 artisan commands (install, make, controller, menu, user, extension, ...)
Layout/ Content, Row, Column (page composition)
Traits/HasAssets CSS/JS registration, template-aware base assets
resources/views/ Classic (Bootstrap 5) views = fallback for every template
resources/views/tailwind-light/ Tailwind Light template (138 Blade files)
resources/views/super-admin-template-1/ Copy of the classic views, selectable by name
resources/assets/ Vendor libraries (axios, flatpickr, choices.js, sortable, sweetalert2, toastify, nprogress, Font Awesome, dual-listbox) and the compiled bundles
resources/lang/ 23 languages
config/admin.php Published configuration
database/migrations/ Admin tables
docs/ This manual and 28 reference pages
tests/ Pest suite (BrowserKit), 819 tests
Design in one paragraph
A controller extends AdminController and returns a Grid, Form or Show built with a fluent PHP API. Each builder renders Blade views from the active template; the shared JavaScript (admin.* namespace) loads pages over PJAX, submits forms, handles inline edits, actions and toasts. All data access goes through Eloquent, so relations, scopes and accessors work as they do in the rest of the application. Authentication uses a dedicated admin guard and its own tables (admin_users, admin_roles, admin_permissions, admin_menu, admin_operation_log), so the admin panel never mixes with the application's users.