Skip to content
@super-admin-org

super-admin-org

Super-Admin Project Summary Overview

Project Overview

Super-Admin is an administrative interface builder for Laravel designed to streamline CRUD backend generation with minimal effort.
It is forked from Laravel-Admin and Open-Admin, ensuring compatibility with Laravel 11 and 12, which older projects no longer support.
The platform is built to provide a consistent, maintainable, and scalable administrative system for developers and teams.


Key Features

  • Automatic CRUD Generation
    Generate Models, Controllers, Views, Migrations, Routes, APIs, and Pest tests directly from a form-based interface.

  • Intelligent File Handling

    • Backups are created before overwriting files.
    • Rollbacks available on failure.
    • Unused scaffold files are removed when deleted.
  • Admin Menu Integration
    Optionally adds generated modules to the admin panel menu for easy navigation.

  • Standardized API Responses
    Includes ResponseMapper trait for consistent and reliable JSON output.

  • Rich Extension Ecosystem
    Available extensions include:

    • helpers: Developer tools for CRUD generation.
    • media-manager: File management from web interface.
    • config: Config manager.
    • grid-sortable: Sortable grids.
    • CkEditor: Rich text editor.
    • api-tester: Test API calls within the admin.
    • scheduling: Manage cronjobs visually.
    • log-viewer: Laravel log inspection.
    • page-designer: Drag-and-drop page builder.
    • reporter: Exception reporting tool.
    • redis-manager: Redis management from admin panel.

Requirements

  • PHP >= 8.2.0
  • Laravel >= 12.0.0
  • Fileinfo PHP Extension

Installation & Setup

  1. Install Laravel (12.0 or higher) and configure your database.
  2. Install Super-Admin:
    composer require super-admin-org/super-admin
  3. Publish assets and configuration:
    php artisan vendor:publish --provider="SuperAdmin\Admin\AdminServiceProvider"
  4. Run installation:
    php artisan admin:install
  5. Access the admin panel at http://localhost/admin
    Default login: admin / admin

Updating

To update assets when upgrading Super-Admin:

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

Testing

  1. Install PHP dependencies:
    composer install
  2. Copy test environment file:
    cp .env.test.sqlite .env
    cp .env.test.sqlite vendor/laravel/laravel/.env
  3. Generate app key (optional):
    php vendor/laravel/laravel/artisan key:generate
  4. Run tests with Pest:
    vendor/bin/pest

Helpers (Scaffolding Extension)

The Helpers Extension provides a web interface for rapid CRUD generation.
It generates the following resources instantly:

  • Eloquent Models
  • Controllers (Admin, Web, API)
  • Migrations
  • Blade Views
  • Routes (Admin, Web, API)
  • Pest Unit & Feature Tests

Advantages

  • Time Saver: Generate CRUD modules in seconds.
  • Consistency: Standard Laravel structure enforced.
  • Safety: Backup + rollback prevents data/code loss.
  • Extensible: Developers can add custom generation rules.

Workflow (Simplified)

  1. Open Scaffold Form → Fill in details.
  2. Submit form → Data stored in DB.
  3. Laravel resources generated automatically.
  4. Routes + Menu entries updated.
  5. Manage modules via dashboard.

Example Generated Structure

app/
├─ Admin/Controllers/StudentInfoController.php
├─ Http/Controllers/Api/StudentInfoApiController.php
├─ Http/Controllers/Web/StudentInfoController.php
├─ Models/StudentInfo.php

database/migrations/
├─ 2025_..._create_student_info_table.php

resources/views/student_infos/
├─ index.blade.php
├─ create.blade.php
├─ edit.blade.php
├─ _form.blade.php

routes/
├─ api.php
├─ web.php

tests/
├─ Pest.php
├─ Unit/Models/StudentInfoTest.php
├─ Feature/API/StudentInfoApiTest.php
├─ Feature/Web/StudentInfoWebTest.php
├─ Feature/Admin/StudentInfoAdminTest.php

Tutorial Highlights

  1. Super-Admin Extension Integration

    • Integrates into dashboard.
    • Registers routes and menu items.
  2. Scaffold Management Interface

    • Web UI form for defining new CRUD modules.
    • Supports creating models, controllers, migrations, Blade CRUD, APIs, and tests.
  3. Scaffold Data Model

    • Stores blueprints in database (helper_scaffolds and helper_scaffold_details).
    • Ensures persistent, editable, and consistent module storage.
  4. Code Generation Engine

    • Uses stub templates to generate Laravel files automatically.
    • Specialized creators: ModelCreator, ControllerCreator, MigrationCreator, ApiControllerCreator, etc.
  5. Database-to-Scaffold Importer

    • Allows importing existing database tables into scaffolds.
    • Simplifies working with legacy databases.

Contribution Guidelines

Super-Admin welcomes contributions of all types:

  • QA: Bug reports with detailed reproduction steps.
  • Code: Fixes, features, or comments on issues.
  • Translations: Create translation files.
  • Community: Meetups, talks, blog posts.
  • Financial Support: Donations to sustain open-source development.

Submit code changes as Pull Requests with descriptions and tests.
For questions, open an issue or email: hello@super-admin.opencollective.com.


Benefits Recap

  • Rapid Development: Ship modules faster.
  • Consistency: Standardized patterns reduce errors.
  • Safety: Rollbacks and logs ensure reliability.
  • Extensibility: Easily extend with new generators and extensions.
  • Community Driven: Actively maintained, welcoming contributions.

License

Licensed under the MIT License.
Forked and inspired by:

Maintained by Super-Admin Org.


Pinned Loading

  1. super-admin super-admin Public

    PHP 5 1

  2. helpers helpers Public

    super-admin-helpers

    PHP 4

  3. log-viewer log-viewer Public

    PHP

Repositories

Showing 10 of 14 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…