|
Template · Boilerplate · Feature Slice — from a single migration or ERD
|
php artisan goat:make ProductYou paste a schema. GOAT ships the whole slice — not just a controller.
|
You give Schema::create('products', function($t){
$t->id();
$t->foreignId('category_id')->constrained();
$t->string('name');
$t->decimal('price',10,2);
$t->timestamps();
});or a plain ERD: |
You get — template-ready Service → Repository, Resource, Policy, Tests included. |
No AI. No SaaS. No web UI. Pure PHP — runs 100% locally.
| CRUD generator | GOAT — Feature / Template / Boilerplate |
|---|---|
| Model + Controller | + Service + Repository (separation) |
| No validation | + Store/Update Requests with inferred rules |
| No API layer | + JsonResource |
| No auth | + Policy (7 methods) |
| No tests | + Feature tests (5 scenarios) |
| One table = one file | ERD with N tables → N slices |
| Hardcoded paths | All paths & namespaces configurable |
| Fixed stubs | Publish & customize — vendor:publish --tag=goat-stubs |
Use it as:
- CRUD scaffold for admin panels
- Feature slice for clean architecture (Service/Repo)
- Boilerplate / template for new domains (
Inventory,Order,Booking) - Rapid prototyping from an ERD whiteboard
composer require meehh/laravel-goat --dev
php artisan goat:make Product🐐 GOAT — Laravel Feature Generator
How do you want to define Product?
❯ Paste Migration
Paste ERD
Use Existing Migration
Paste your migration. Press Ctrl+D when finished:
> Schema::create('products', ...);
> ^D
✓ Schema detected
Product (products)
├── id bigInteger (PK)
├── category_id foreignId → categories.id
├── name string
├── price decimal
└── created_at timestamp
Generate:
✓ Model ✓ Migration ✓ Requests ✓ Resource ✓ Controller ✓ Service ✓ Repository ✓ Policy ✓ Tests
✓ app/Models/Product.php
✓ app/Services/ProductService.php
...
🐐 GOAT generated Product successfully!
CI / non-interactive
cat migration.php | php artisan goat:make Product --from=migration --force
cat erd.txt | php artisan goat:make Product --from=erd --force
php artisan goat:make Product --from=database/migrations/2024_01_01_create_products_table.php
php artisan goat:make Product --only=model,resource,request
php artisan goat:make Product --except=policy,test
# custom paths — e.g. repo/admin instead of repositories/
php artisan goat:make Hello --paths=repository=app/Repo/Admin,model=app/Domain/Models --force
# → app/Repo/Admin/HelloRepository.php (App\Repo\Admin) + app/Domain/Models/Hello.php
php artisan goat:make World --module=Admin --force
# → app/Modules/Admin/Models/World.php + app/Modules/Admin/Repositories/...
# interactive: after schema preview GOAT asks “Customize output paths?” → type per componentNo more locked app/Repositories. Put any artifact anywhere — per run, no config edit needed:
# single: repo/Admin instead of repositories/
php artisan goat:make Hello --paths=repository=app/Repo/Admin --force
# → app/Repo/Admin/HelloRepository.php (namespace App\Repo\Admin auto)
# multiple: split models & repos
php artisan goat:make Hello --paths=repository=app/Repo/Admin,model=app/Domain/Models --force
# → app/Domain/Models/Hello.php (App\Domain\Models)
# module: group everything under app/Modules/{Module}
php artisan goat:make World --module=Admin --force
# → app/Modules/Admin/Models/World.php
# app/Modules/Admin/Repositories/WorldRepository.php
# app/Modules/Admin/Services/WorldService.php
# tests/Feature/Modules/Admin/WorldTest.php
# interactive: no flags → after schema GOAT asks “Customize output paths?” → y → type per component
php artisan goat:make Product--paths is key=path comma-separated (model,migration,request,resource,controller,service,repository,policy,test). Paths can be absolute or app/... relative — namespaces inferred automatically (app/Repo/Admin → App\Repo\Admin). For permanent change, publish config/goat.php.
Migration — understands Blueprint:
id, string, text, integer, bigInteger, decimal, float, boolean, date, datetime, timestamp, foreignId, uuid, json, enum, softDeletes, timestamps, unique, nullable, default, constrained, index…
ERD — plain text, forgiving:
inventories
------------
id bigint PK
product_name varchar
sku varchar UNIQUE
quantity integer
price decimal(10,2)
created_at timestamp
No type? Inferred (quantity→integer, price→decimal, description→text). Handles PK, FK -> categories.id, UNIQUE, DEFAULT 0, varchar(100).
ERD full example
products
---------
id bigint PK
category_id bigint FK -> categories.id
name varchar
price decimal(10,2)
categories
----------
id bigint PK
name varchar
GoatSchema is the single source of truth — parsers feed it, 9 generators consume it.
Product.php — fillable, casts, belongsTo(Category::class)
protected $fillable = ['category_id','name','price'];
protected function casts(): array { return ['price' => 'decimal:2']; }
public function category(){ return $this->belongsTo(Category::class,'category_id'); }Requests — required/sometimes + string/integer/numeric/exists:categories,id/unique + max:255
Controller — thin index/store/show/update/destroy, delegates to ProductService, uses ProductResource
Service ↔ Repository — business vs query split, paginate/all/find/create/update/delete
Policy — viewAny/view/create/update/delete/restore/forceDelete (edit stub to fit)
Test — test_can_list_products … test_can_delete_product with factory payloads
// config/goat.php
return [
'paths' => [
'model' => app_path('Models'),
'migration' => database_path('migrations'),
'request' => app_path('Http/Requests'),
'resource' => app_path('Http/Resources'),
'controller' => app_path('Http/Controllers'),
'service' => app_path('Services'),
'repository' => app_path('Repositories'),
'policy' => app_path('Policies'),
'test' => base_path('tests/Feature'),
],
'namespaces' => ['model' => 'App\\Models', /* ... */],
'generate' => ['model'=>true, /* ... */],
];Stubs — one per artifact:
stubs/model.stub, migration.stub, request.stub, resource.stub,
controller.stub, service.stub, repository.stub, policy.stub, test.stub
php artisan vendor:publish --tag=goat-stubs
# → resources/stubs/vendor/goat/*.stub — edit once, generate foreverStubRenderer prefers your published stub, falls back to package default.
- Never overwrites without
--force→⚠ Product.php already exists. Use --force - Validates
--only/--except, empty input, unsupported types, bad table names — no stack trace dumps - Naming via
NameResolver(products→Product,product_items→ProductItem,category_id→category) --only=model,resource --except=policycomposable
src/
├── Commands/MakeCommand.php # UX, STDIN, --from/--only/--except/--force
├── Parsers/MigrationParser.php # Blueprint → GoatSchema
│ ErdParser.php # ERD → GoatSchema (infer types)
├── Schema/GoatSchema|Table|Column|Relationship # ← single source
├── Generators/* (9) # Model/Migration/Request/Resource/Controller/Service/Repository/Policy/Test
├── Support/NameResolver|StubRenderer|FileWriter|GoatConfig
└── GoatServiceProvider.php # config + publish + command
No giant generator. Each artifact isolated, stub-driven, testable.
composer install
composer test # vendor/bin/phpunit — 40 testsCovers: migration/ERD parsing, columns, relationships, naming, 9 generators, CLI, --only/--except/--force, file protection, stubs.
composer config repositories.goat vcs https://github.com/CodeWithTeds/meehh.git
composer require meehh/laravel-goat:@dev --devOnce on Packagist: composer require meehh/laravel-goat --dev
Requires PHP ^8.3 · Laravel 11|12|13
--api/--webpresets, enum casts, factories,--allfor multi-table ERD,goat:make --from=openapi
PRs welcome. Build your next feature with php artisan goat:make.
Built for builders who ship features, not boilerplate.
MIT · Owned by Prof Alex Software Dev / TE-AD · github.com/CodeWithTeds/meehh · Report issue · php artisan goat:make