README

The ultimate Laravel scaffolding & workflow package.
Generate complete resource stacks, run Artisan workflows, and supercharge your development speed.

What's New in v2.0

Requirements

• PHP >= 8.2
• Laravel 11.x, 12.x, or 13.x

Installation

composer require rahasistiyak/laravel-super-artisan

Publish the config and stubs:

# Publish config (optional but recommended)
php artisan vendor:publish --tag=super-artisan-config

# Publish stubs (to customize templates)
php artisan vendor:publish --tag=super-artisan-stubs

This creates:

• config/super-artisan.php — Define your blueprints and workflows.
• stubs/vendor/super-artisan/ — Customize every generated file template.

Available Commands

make:super — Resource Generator

Signature

php artisan make:super {name} [options]

Options

Examples

Basic CRUD (Blade Views)

php artisan make:super Post

Generates: Model, Migration, Factory, Controller, 4 Blade views

Bulk Generation

php artisan make:super Post,Comment,Tag

Generates the full stack for all three resources at once.

API Resource

php artisan make:super Post --api

Generates: Model, Migration, Factory, API Controller (JSON responses, no views)

Repository Pattern

php artisan make:super Post --pattern=repository

Generates: Model + Migration + Repository class + Interface + RepositoryServiceProvider binding + Controller with DI

Filament Resource

php artisan make:super Post --filament

Generates: Model + Migration + Filament v3 Resource (requires filament/filament)

Domain-Driven Layout

php artisan make:super Post --domain=Blog

Generates: app/Http/Controllers/Blog/PostController.php, views in resources/views/Blog/post/

Livewire

php artisan make:super Post --livewire

Vue / React

php artisan make:super Post --vue
php artisan make:super Post --react

Blueprint

php artisan make:super Post --blueprint=full-stack

Runs the full-stack blueprint: Model + Repository + Policy + FormRequests + Controller.

Dry Run

php artisan make:super Post --api --domain=Blog --dry-run

Preview exactly what would be created — nothing is written to disk.

Force Overwrite

php artisan make:super Post --force

run:workflow — Workflow Runner

Execute predefined sequences of Artisan commands.

Signature

php artisan run:workflow {workflow} [options]

Options

Built-in Workflows

Examples

# Standard deployment
php artisan run:workflow deploy

# Preview what deploy would do
php artisan run:workflow deploy --dry-run

# Test then deploy, stop if tests fail
php artisan run:workflow test-and-deploy --stop-on-failure

# Fresh database for local dev
php artisan run:workflow fresh

# List all workflows
php artisan run:workflow deploy --list
# or
php artisan super:list

make:repository — Repository Generator

Generates the full repository triad:

1. Repository class (app/Repositories/{Name}Repository.php)
2. Interface (app/Repositories/Contracts/{Name}RepositoryInterface.php)
3. Service Provider binding (app/Providers/RepositoryServiceProvider.php)

php artisan make:repository PostRepository --model=Post

Options

After generation: Add RepositoryServiceProvider::class to bootstrap/providers.php (Laravel 11+).

make:service — Service Generator

php artisan make:service PostService --model=Post

Generates: app/Services/PostService.php with typed methods and constructor injection.

Additional Generators

make:super-request

php artisan make:super-request StorePostRequest --rules=title:required,body:required|max:500

Generates: app/Http/Requests/StorePostRequest.php with pre-filled validation rules.

make:super-policy

php artisan make:super-policy PostPolicy --model=Post

Generates: app/Policies/PostPolicy.php with all standard Gate methods (viewAny, view, create, update, delete, restore, forceDelete).

make:super-action

php artisan make:super-action CreatePost --model=Post

Generates: app/Actions/CreatePost.php — a single-responsibility action class.

super:list — Discovery Helper

# List all workflows
php artisan super:list

# List all blueprints
php artisan super:list --blueprints

# List everything
php artisan super:list --all

Blueprints

Blueprints define reusable file-generation templates. Define your own in config/super-artisan.php.

Built-in Blueprints

Custom Blueprint Example

// config/super-artisan.php
'blueprints' => [
    'my-api' => [
        'description' => 'My custom API resource.',
        'commands' => [
            'make:model {name} -m -f',
            'make:super-request Store{name}Request',
            'make:super-request Update{name}Request',
            'make:super {name} --api',
        ],
    ],
],

php artisan make:super Product --blueprint=my-api

Custom Workflows

// config/super-artisan.php
'workflows' => [
    'my-deploy' => [
        'description' => 'My custom deployment steps.',
        'commands' => [
            'down',
            'migrate --force',
            'db:seed --class=ProductionSeeder',
            'optimize',
            'up',
        ],
    ],
],

php artisan run:workflow my-deploy --stop-on-failure

Customizing Stubs

After publishing, edit stubs in stubs/vendor/super-artisan/:

Available Tokens

Repository Pattern — How It Works

When using --pattern=repository or make:repository, the package generates:

1. Repository class — Implements RepositoryInterface from the package with all(), find(), findOrFail(), create(), update(), delete(), paginate(), firstWhere(), count().

2. Repository interface — Extends the base RahasIstiyak\SuperArtisan\Contracts\RepositoryInterface. Add model-specific methods here.

3. Service provider binding — Binds the interface to the concrete class via IoC. Register it in bootstrap/providers.php:

// bootstrap/providers.php
return [
    App\Providers\AppServiceProvider::class,
    App\Providers\RepositoryServiceProvider::class, // 👈 Add this
];

1. Controller with DI — The generated controller receives the repository interface via constructor injection, promoting testability and loose coupling.

Testing

vendor/bin/phpunit

Run tests with coverage:

vendor/bin/phpunit --coverage-text

Contributing

Contributions are welcome! Please submit pull requests or issues to the GitHub repository.

Please follow the existing code style and write tests for any new features.

License

This package is licensed under the MIT License.

Contact

Email: rahasistiyak.official@gmail.com
GitHub: rahasistiyakofficial