Laravel Saiman CRUD Generator

Generate complete, production-ready CRUD modules for your Laravel application with a single Artisan command. Stop writing boilerplate — start building features.

✨ Features

Requirements

• PHP 8.2, 8.3, or 8.4
• Laravel 10, 11, or 12

Installation

composer require saiman/laravel-saiman-crud --dev

Laravel auto-discovers the service provider. No manual registration needed.

Quick Start

php artisan make:crud Product

Generates 10+ files instantly:

✓ Model       → app/Models/Product.php
✓ Migration   → database/migrations/xxxx_create_products_table.php
✓ Controller  → app/Http/Controllers/ProductController.php
✓ Requests    → app/Http/Requests/StoreProductRequest.php
✓ Requests    → app/Http/Requests/UpdateProductRequest.php
✓ Views       → resources/views/products/{index,create,edit,show}.blade.php
✓ Routes      → Appended to routes/web.php
✓ Seeder      → database/seeders/ProductSeeder.php
✓ Factory     → database/factories/ProductFactory.php

Then:

php artisan migrate
php artisan db:seed --class=ProductSeeder

Visit /products — your CRUD is live.

Configuration

Publish the config to customise namespaces, paths, layout, and more:

php artisan vendor:publish --tag=crud-generator-config

Key options in config/crud-generator.php:

'namespaces' => [
    'model'      => 'App\\Models',
    'controller' => 'App\\Http\\Controllers',
    // ...
],
'views' => [
    'layout' => 'layouts.app',  // ← your Blade layout
],
'soft_deletes' => false,
'pagination'   => 15,

Field Definitions

php artisan make:crud Product \
  --fields="name:string,price:decimal,stock:integer,active:boolean,description:text:nullable"

Supported Types

Modifiers

Append after type:

--fields="email:email:unique,bio:text:nullable"

Available Commands & Flags

php artisan make:crud {Model} [options]

Examples

# Web CRUD with fields
php artisan make:crud Product \
  --fields="name:string,price:decimal,active:boolean"

# Full API stack
php artisan make:crud Product --api --service --repository \
  --fields="name:string,price:decimal,sku:string:unique"

# Livewire CRUD
php artisan make:crud Product --livewire \
  --fields="name:string,price:decimal"

# Filament Resource
php artisan make:crud Product --filament \
  --fields="name:string,price:decimal,featured:boolean"

# Overwrite everything
php artisan make:crud Product --force

Publishing Stubs

Customise any generated file by publishing stubs:

php artisan vendor:publish --tag=crud-generator-stubs

Stubs are placed in stubs/crud-generator/. The package will use your custom stubs automatically.

API Reference

make:crud {Model}

Generates a complete CRUD module. {Model} must be PascalCase (e.g. Product, BlogPost).

Field Format

name:type[:modifier[:modifier...]]

Multiple fields are comma-separated:

name:string,price:decimal:nullable,active:boolean

FAQ

Q: Does it work with custom namespaces? A: Yes. Publish the config and set namespaces.* to your values.

Q: Can I use it in a DDD / modular structure? A: Yes. Override paths.* and namespaces.* in the config.

Q: Will it add routes to existing route files? A: Yes, it appends to routes/web.php or routes/api.php. It checks for duplicates to prevent double-registration.

Q: Does --livewire require Livewire to be installed? A: Yes. Install livewire/livewire ^3.0 before using this flag.

Q: Does --filament require Filament to be installed? A: Yes. Install filament/filament ^3.0 before using this flag.

Troubleshooting

"Stub not found" error Run php artisan vendor:publish --tag=crud-generator-stubs and check if the stubs exist in stubs/crud-generator/.

"File already exists" warning Add --force to overwrite: php artisan make:crud Product --force.

Views don't extend my layout Publish the config and change views.layout to your layout name.

Fields not appearing in views Pass --fields when generating. Fields are only injected at generation time.

Upgrade Guide

From 1.x to 2.x

(No breaking changes in 1.x series.)

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md.

Credits

• Saiman — creator
• All Contributors

License

MIT — see LICENSE.