Table of Contents
When developing a Laravel project, developers often find themselves writing and repeating the same trivial codes. Whether it’s making a model, controller view, etc.. and many other files that you would normally create in a Laravel project.
Although artisan commands can help create files and components for your project, these are mostly just blank classes that you need to fill in with your logic.
In comes blueprint, this package lets you generate Laravel codes a lot faster using a draft file. Here, you can define models and controllers with shorthand YAML syntax making it easy to build new components in your Laravel application.
Blueprint is an open-source tool for rapidly generating multiple Laravel components from a single, human-readable definition.
Let’s Start by Installing Blueprint
Note! For this package to work, your Laravel installation version should be at least version 6 or higher.
Install Blueprint using this command:
composer require --dev laravel-shift/blueprint
Blueprint automatically discovers the package. Therefore, you don’t need to register your application in AppServiceProvider.php
.
Defining Components in Yaml file
First, create a draft.yml
in the root of your Laravel application directory.
You can easily do this using blueprint:new
command.
php artisan blueprint:new
This will create a new draft.yml file with sections for where to put the models
and controllers
.
For instance, here’s a sample of syntax to generate components for a blog website.
models:
Post:
title: string:400
content: longtext
published_at: nullable timestamp
author_id: id:user
controllers:
Post:
index:
query: all
render: post.index with:posts
store:
validate: title, content, author_id
save: post
send: ReviewPost to:post.author.email with:post
dispatch: SyncMedia with:post
fire: NewPost with:post
flash: post.title
redirect: post.index
Generating Components Defined in Yaml file
After that, you can simply generate all of this using blueprint:build
a command.
By default, the blueprint will attempt to load draft.yml from the root of the project. But you can also specify the path draft.yml
file by passing a single argument blueprint:build [draft]
.
php artisan blueprint:build
Next, we will execute the command and the blueprint will generate all of these files and even update routes/web.php.
Created:
- database/migrations/2020_07_21_054321_create_posts_table.php
- app/Post.php
- database/factories/PostFactory.php
- app/Http/Controllers/PostController.php
- app/Events/NewPost.php
- app/Http/Requests/PostStoreRequest.php
- app/Jobs/SyncMedia.php
- app/Mail/ReviewPost.php
- resources/views/post\index.blade.php
- tests/Feature/Http/Controllers/PostControllerTest.php
Updated:
- routes/web.php
Revert Generated Files
You can also revert if you made mistakes anytime using blueprint:erase
command.
php artisan blueprint:erase
This command will undo changes in routes and delete the list of files generated last time using blueprint:build
command.
If you are interested you can learn more about this package in blueprint documentation and view their source code in Laravel-shift/blueprint.