Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| No styling or empty icon boxes | Assets not published or stale | php artisan vendor:publish --tag=super-admin-assets --force, hard refresh |
| Disk [admin] not configured | Missing disk | Add it to config/filesystems.php (Installation) |
| Uploaded images do not show | Disk url or APP_URL wrong | Match APP_URL to the address in the browser |
| 500 after login: member function get() on array | Package older than 1.3.0 with JSON sessions | Update |
| Template change not visible | Cached views/config | php artisan view:clear && php artisan config:clear |
| Every page says Unauthorized | User lacks a matching permission | Grant it on the Permissions page, or set check_route_permission to false while debugging |
| Menu item missing for a user | Role or permission restriction on the item | Edit the item, or set check_menu_roles to false |
| Too many login attempts | Throttle (5 attempts / 15 min) | Wait or change auth.throttle_* |
| Mixed content behind HTTPS proxy | http URLs generated | ADMIN_HTTPS=true |
| Some grid columns missing | Column selector preference in the browser | Open the selector and press All |
| Inline edit popover does not open in a custom template | No Bootstrap JS and no Tailwind bundle | Load tailwind-light/dist/super-admin-js.js or Bootstrap 5 JS |
Route admin.login not found when routes load late | Name lookups stale | 1.3.0 refreshes them; otherwise call refreshNameLookups() |
Logs: admin actions on the Operation log page; PHP errors in storage/logs/laravel.log; browser errors in the developer console.