README

Laravel Auto CRUD

Generate complete CRUD scaffolding in seconds

Installation • Quick Start • Features • Documentation

⚡ Features

📋 Requirements

• PHP 8.2+
• Laravel 11.x or 12.x

📦 Installation

composer require mosweed/laravel-auto-crud

Publish Layout & Welcome Page

php artisan crud:layout --welcome

Publish Configuration (Optional)

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

🚀 Quick Start

# 1. Publish layout and welcome page
php artisan crud:layout --welcome

# 2. Generate a complete CRUD
php artisan make:crud Product \
    --fields="name:string,price:decimal,description:text:nullable" \
    --belongsTo=Category \
    --all \
    --add-to-nav

# 3. Run migrations
php artisan migrate

# 4. Build assets
npm run build

Your CRUD is ready at /products ✨

💻 Usage

Basic Command

php artisan make:crud Post

This generates:

• ✅ Model with Filterable and Sortable traits
• ✅ Web Controller
• ✅ API Controller
• ✅ Form Requests (Store & Update)
• ✅ Policy
• ✅ Blade Views (index, create, edit, show)
• ✅ Routes in web.php and api.php

Command Options

Defining Fields

php artisan make:crud Post --fields="title:string,body:text,is_published:boolean"

Supported Types

Modifiers

--fields="title:string:255,slug:string:unique,body:text:nullable"

• nullable - Field can be null
• unique - Add unique constraint
• 255 - String length

Relationships

# BelongsTo
php artisan make:crud Post --belongsTo=User --belongsTo=Category

# HasMany
php artisan make:crud User --hasMany=Post

# BelongsToMany
php artisan make:crud Post --belongsToMany=Tag

JSON Configuration

Create a crud.json file:

{
    "models": [
        {
            "name": "Product",
            "fields": [
                {"name": "name", "type": "string"},
                {"name": "price", "type": "decimal"}
            ],
            "relationships": [
                {"type": "belongsTo", "model": "Category"}
            ]
        }
    ],
    "options": {
        "all": true,
        "softDeletes": true
    }
}

Run:

php artisan make:crud --json=crud.json

🏠 Layout Command

php artisan crud:layout

Welcome Page

# Layout + welcome page together
php artisan crud:layout --welcome

# With Bootstrap
php artisan crud:layout --css=bootstrap --welcome

🔍 Filtering & Sorting

The generated models include Filterable and Sortable traits:

// Filter
GET /products?status=active
GET /products?price_from=10&price_to=100
GET /products?search=keyword

// Sort
GET /products?sort=name&direction=asc

// Soft Deletes
GET /products?trashed=1

🎨 Tailwind v4 Colors

Laravel 12 uses Tailwind v4 by default. Edit resources/css/app.css:

@theme {
    /* Primary - Change to green */
    --color-primary-500: #22c55e;
    --color-primary-600: #16a34a;
    --color-primary-700: #15803d;

    /* Secondary */
    --color-secondary-500: #6366f1;
    --color-secondary-600: #4f46e5;
}

📁 Generated Files

app/
├── Http/Controllers/
│   ├── ProductController.php
│   └── Api/ProductController.php
├── Http/Requests/Product/
│   ├── StoreProductRequest.php
│   └── UpdateProductRequest.php
├── Models/Product.php
└── Policies/ProductPolicy.php

database/
├── factories/ProductFactory.php
├── migrations/xxxx_create_products_table.php
└── seeders/ProductSeeder.php

resources/views/
├── components/app-layout.blade.php
├── welcome.blade.php
└── products/
    ├── index.blade.php
    ├── create.blade.php
    ├── edit.blade.php
    └── show.blade.php

📖 Documentation

For complete documentation, see DOCUMENTATION.md.

🧪 Testing

composer test

📝 Changelog

See CHANGELOG.md for recent changes.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🔒 Security

If you discover any security-related issues, please open an issue on GitHub.

👨‍💻 Credits

• Mosweed

📄 License

The MIT License (MIT). See LICENSE for more information.

⬆ Back to Top

Made with ⚡ by Mosweed