README

This Laravel package provides a php artisan make:action command to quickly scaffold "Action" classes. This encourages organized and reusable business logic.

Compatibility

This package is tested and compatible with:

The package works seamlessly alongside Filament projects without any conflicts.

Installation

You can install the package via composer:

composer require webteractive/make-action

You can publish the config file with:

php artisan vendor:publish --tag="make-action-config"

This is the contents of the published config file:

// config for Webteractive/MakeAction
return [
    'method_name' => 'handle',
];

Usage

To create a new action class, run the make:action Artisan command:

php artisan make:action CreateNewUser

This will create a new action class at app/Actions/CreateNewUser.php:

<?php

namespace App\Actions;

class CreateNewUser
{
    public function handle()
    {
        // TODO: Implement the action logic.
    }
}

You can customize the default method name (handle) by changing the method_name value in the config/make-action.php file:

// config for Webteractive/MakeAction
return [
    'method_name' => 'execute',
];

Laravel Boost Support

This package includes AI guidelines for Laravel Boost, providing AI agents with context on how to properly use the make:action command.

Enabling Boost Guidelines

To include this package's guidelines in your AI context:

1. Add to your boost.json:

   {
       "guidelines": [
           "webteractive/make-action"
       ]
   }

2. Update Boost:

   php artisan boost:update

Once enabled, AI coding assistants will:

• Generate correct make:action commands
• Create action classes following Laravel conventions
• Provide appropriate examples when working with the action pattern

The guidelines are automatically discovered from resources/boost/guidelines/core.blade.php when you opt-in.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Glen Bangkila
• All Contributors

License

The MIT License (MIT). Please see License File for more information.