redbastie/crudify

A Laravel 8 CRUD package for rapid scaffolding and development.

1.0.4 2020-09-24 09:20 UTC

This package is auto-updated.

Last update: 2024-03-29 04:19:35 UTC


README

This package is no longer maintained. Please consider my latest package here: https://github.com/redbastie/tailwire

Crudify

Crudify is a Laravel 8 CRUD package which promotes rapid scaffolding and development. It uses a tried and true stack and intuitive techniques that will save you time and hassles.

68747470733a2f2f692e696d6775722e636f6d2f6e65467a3855652e706e67

Requirements

  • A server compatible with Laravel 8
  • Composer
  • NPM

Features

  • Automatic user timezones
  • AJAX forms, modals, and response handlers
  • Responsive data tables
  • Font Awesome icons
  • Sensible Bootstrap styling out of the box
  • CRUD generator command (make:crud)
  • Automatic migrations command (migrate:auto)
  • Migration, factory, and rule definitions inside models
  • Automatic routing based on controller methods
  • Dynamic model fillables
  • & more

Third Party Packages Used

Links

Installation

Crudify was designed to work with a clean Laravel 8 install.

Install Laravel:

laravel new vehicle-app

Configure the database in your .env file:

DB_DATABASE=vehicle_app
DB_USERNAME=root
DB_PASSWORD=

Now, install Crudify via composer:

composer require redbastie/crudify

Then, run the Crudify install command:

php artisan crudify:install

All done. The only thing left to do is create a user, either via tinker or the DatabaseSeeder.

Usage Example

Generate CRUD for a new model e.g. a Vehicle

php artisan make:crud Vehicle

This will generate your controller, data table, model, factory, views, nav item, and auto route.

Modify the migration method inside the new Vehicle model class:

public function migration(Blueprint $table)
{
    $table->id();
    $table->timestamps();
    $table->string('name');
    $table->string('brand');
}

You can also specify the factory definition and rules in the model:

public static function definition(Generator $faker)
{
    return [
        'name' => $faker->name,
        'brand' => $faker->company,
    ];
}

public static function rules(Vehicle $vehicle = null)
{
    return [
        'name' => ['required', Rule::unique('vehicles')->ignore($vehicle->id ?? null)],
        'brand' => ['required'],
    ];
}

Specify a Vehicle seeder in the DatabaseSeeder class:

\App\Models\User::factory()->create([
    'email' => 'admin@example.com',
]);

\App\Models\Vehicle::factory(100)->create();

Note that I've added a User seeder here as well, which we will use to log in with using the password password after.

Add some data table columns in the VehicleDataTable class:

protected function getColumns()
{
    return [
        Column::make('id'),
        Column::make('name'),
        Column::make('brand'),
        Column::make('created_at'),
        Column::computed('action')->title(''),
    ];
}

Add form fields in the vehicles/form.blade.php view file:

<x-form-input label="{{ __('Name') }}" name="name"/>
<x-form-input label="{{ __('Brand') }}" name="brand"/>

Run a fresh automatic migration command with seeding:

php artisan migrate:auto --fresh --seed

You can specify --fresh and/or --seed in the migrate:auto command in order to run fresh migrations and/or seed afterwards.

Now you should be able to login to your app and click on the Vehicles link in the navbar to perform CRUD operations on the seeded data.

To get an idea how the automatic routing works, check out the VehicleController. After updating controller methods, use php artisan route:list to see your route info.