README

Supercharge your Laravel development workflow with instant module scaffolding.

Laravel TurboMaker is a productivity-focused package designed to save hours of repetitive setup work.
With a single command, you can scaffold complete modules (models, migrations, controllers, routes, tests, views, policies, factories...) following Laravel best practices.

✨ Features

• ⚡ One-command scaffolding – Generate a full CRUD or API module instantly
• 📋 Schema-based generation – Define models with YAML schemas for complex projects
• 📦 Complete structure – Models, controllers, migrations, requests, resources, views & tests
• 🔒 Security ready – Generates Policies and authentication hooks out of the box
• 🧪 Built-in testing – Pest tests automatically generated for each action
• 🔌 Extensible field types – 65+ built-in types + create custom field types
• ⚙️ Advanced generators – Actions, Services, Rules, Observers for clean architecture
• 🎨 Custom templates – Override stubs and templates to match your coding style
• 🌐 API & Web ready – Separate API Resources & Controllers when needed
• 🚀 Laravel 11+ compatible – Auto-detection and smart configuration

📦 Installation

composer require --dev grazulex/laravel-turbomaker

Requirements:

• PHP 8.3+
• Laravel 11.x | 12.x

🚀 Quick Start

Generate Complete Module

php artisan turbo:make Post

What's Generated:

• Model: app/Models/Post.php with relationships
• Controllers: Web & API controllers with CRUD operations
• Migrations: Database table with proper columns and indexes
• Form Requests: Validation for Store/Update operations
• API Resources: JSON transformations for API responses
• Views: Complete CRUD views (index, create, edit, show)
• Routes: Both web and API routes with correct naming
• Tests: Feature and unit tests using Pest framework
• Factory: Model factory for testing and seeding

Schema-Based Development

# Create a schema file
php artisan turbo:schema create Product --fields="name:string,price:decimal,category_id:foreignId"

# Generate from schema
php artisan turbo:make Product --schema=Product

API-First Development

php artisan turbo:api Product --tests --policies

Generates API-only components (no views) with authentication and authorization.

Add Relationships

php artisan turbo:make Comment --belongs-to=Post --belongs-to=User

Automatically handles foreign keys, model relationships, and form integration.

📚 Documentation & Examples

📖 Complete documentation and examples have been moved to the GitHub Wiki

Quick Links:

🔧 Available Commands

➡️ See complete command reference

🏭 Enterprise Features

ModelSchema Integration

• 65+ Field Types with automatic validation
• Fragment Architecture for 95% faster generation
• Enterprise Validation with diff and optimization tools
• Schema Templates for common patterns (blog, ecommerce, etc.)

Advanced Generators

• 13 Generator Types - Models, Controllers, Tests, Policies, etc.
• Smart Relationships - Automatic foreign keys and model relationships
• Custom Actions & Services - Clean architecture patterns
• Validation Rules - Custom validation with type-specific rules

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

git clone https://github.com/grazulex/laravel-turbomaker.git
cd laravel-turbomaker
composer install
./vendor/bin/pest

� License

This package is open-sourced software licensed under the MIT license.

🔗 Related Packages

• Laravel ModelSchema - The enterprise engine powering TurboMaker
• Schema Templates - Pre-built schema examples

Made with ❤️ for the Laravel community

Generate Complete Module

php artisan turbo:make Post

What's Generated:

• Model: app/Models/Post.php with relationships
• Controllers: Web & API controllers with CRUD operations
• Migrations: Database table with proper columns and indexes
• Form Requests: Validation for Store/Update operations
• API Resources: JSON transformations for API responses
• Views: Complete CRUD views (index, create, edit, show)
• Routes: Both web and API routes with correct naming
• Tests: Feature and unit tests using Pest framework
• Factory: Model factory for testing and seeding

Schema-Based Development

# Create a schema file
php artisan turbo:schema create Product --fields="name:string,price:decimal,category_id:foreignId"

# Generate from schema
php artisan turbo:make Product --schema=Product

API-First Development

php artisan turbo:api Product --tests --policies

Generates API-only components (no views) with authentication and authorization.

Add Relationships

php artisan turbo:make Comment --belongs-to=Post --belongs-to=User

Automatically handles foreign keys, model relationships, and form integration.

� Documentation & Examples

📖 Complete documentation and examples have been moved to the GitHub Wiki

Quick Links:

🏭 13 Enterprise Generators

TurboMaker generates 13 different types of files for complete module scaffolding:

🔍 Available Commands

Key Options

🛠 Configuration

Publish the configuration file to customize TurboMaker:

php artisan vendor:publish --tag=turbomaker-config

Publish custom templates:

php artisan vendor:publish --tag=turbomaker-stubs

See the Configuration Wiki for complete details.

🎯 Field Types & Extensibility

TurboMaker includes 65+ built-in field types and supports custom field type creation:

Built-in Types

String Types: string, text, longText, mediumText
Integer Types: integer, bigInteger, unsignedBigInteger, tinyInteger, smallInteger
Numeric Types: decimal, float, double, boolean
Date/Time: date, dateTime, timestamp, time
Geometry: point, lineString, polygon, multiPoint, multiLineString, multiPolygon, geometryCollection
Advanced: json, uuid, email, foreignId, morphs, binary, enum, set, fullText, char, year
MongoDB: objectId, binaryUuid

Custom Field Types

Create your own field types by extending AbstractFieldType:

// config/turbomaker.php
'custom_field_types' => [
    'money' => App\TurboMaker\FieldTypes\MoneyFieldType::class,
    'slug' => App\TurboMaker\FieldTypes\SlugFieldType::class,
],

See the Field Types Wiki for complete documentation.

🆕 Version Compatibility

🤝 Contributing

We welcome contributions! See our Contributing Guide.

Made with ❤️ for the Laravel community

📖 Documentation • 🐛 Report Issues • 💬 Discussions