PHPackages                             laravel-shift/blueprint - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. laravel-shift/blueprint

ActiveLibrary[Framework](/categories/framework)

laravel-shift/blueprint
=======================

An expressive, human readable code generation tool.

v2.13.0(6mo ago)3.1k1.4M—6.4%298[12 issues](https://github.com/laravel-shift/blueprint/issues)20MITPHPCI passing

Since Nov 6Pushed 2mo ago51 watchersCompare

[ Source](https://github.com/laravel-shift/blueprint)[ Packagist](https://packagist.org/packages/laravel-shift/blueprint)[ RSS](/packages/laravel-shift-blueprint/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (11)Versions (78)Used By (20)

 [![Build Status](https://github.com/laravel-shift/blueprint/workflows/Build/badge.svg)](https://github.com/laravel-shift/blueprint/actions) [![Latest Stable Version](https://camo.githubusercontent.com/004f5a6b3a9a88c081cf9d2e95b32bc8854de0b32032aeca84a96dd9e4acf3ba/68747470733a2f2f706f7365722e707567782e6f72672f6c61726176656c2d73686966742f626c75657072696e742f762f737461626c652e737667)](https://packagist.org/packages/laravel-shift/blueprint) [![License](https://camo.githubusercontent.com/0d94d95e9510689c31fc0b3860e186b170c5ba7c212b169c1597212b54a47711/68747470733a2f2f706f7365722e707567782e6f72672f6c61726176656c2d73686966742f626c75657072696e742f6c6963656e73652e737667)](https://github.com/badges/poser/blob/master/LICENSE)

[![Blueprint](blueprint-logo.png)](blueprint-logo.png)

*Blueprint* is an open-source tool for **rapidly generating multiple** Laravel components from a **single, human readable** definition.

Watch a quick [demo of Blueprint](https://www.youtube.com/watch?v=A_gUCwni_6c) in action or continue reading to get started.

Requirements
------------

[](#requirements)

Blueprint requires a Laravel application running a supported version of Laravel. Currently that is Laravel 11 or higher.

Installation
------------

[](#installation)

You may install Blueprint via Composer using the following command:

```
composer require -W --dev laravel-shift/blueprint
```

Blueprint will automatically register itself using [package discovery](https://laravel.com/docs/packages#package-discovery).

If you wish to run the tests generated by Blueprint, you should also install the [Additional Assertions](https://github.com/jasonmccreary/laravel-test-assertions) package:

```
composer require --dev jasonmccreary/laravel-test-assertions
```

Basic Usage
-----------

[](#basic-usage)

Blueprint comes with a set of artisan commands. The one you'll use to generate the Laravel components is the `blueprint:build` command:

```
php artisan blueprint:build
```

The *draft* file contains a [definition of the components](https://blueprint.laravelshift.com/docs/generating-components/) to generate. Let's review the following example draft file which generates some *blog* components:

```
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: posts.index
```

From these 20 lines of YAML, Blueprint will generate all of the following Laravel components:

- A *model* class for `Post` complete with `fillable`, `casts`, and `dates` properties, as well as relationships methods.
- A *migration* to create the `posts` table.
- A [*factory*](https://laravel.com/docs/database-testing) intelligently setting columns with fake data.
- A *controller* class for `PostController` with `index` and `store` actions complete with code generated for each [statement](https://blueprint.laravelshift.com/docs/controller-statements/).
- *Routes* for the `PostController` actions.
- A [*form request*](https://laravel.com/docs/validation#form-request-validation) of `StorePostRequest` validating `title` and `content` based on the `Post` model definition.
- A *mailable* class for `ReviewPost` complete with a `post` property set through the *constructor*.
- A *job* class for `SyncMedia` complete with a `post` property set through the *constructor*.
- An *event* class for `NewPost` complete with a `post` property set through the *constructor*.
- A *Blade template* of `post/index.blade.php` rendered by `PostController@index`.
- An [HTTP Test](https://laravel.com/docs/http-tests) for the `PostController`.
- A unit test for the `StorePostRequest` form request.

***Note:** This example assumes features within a default Laravel application such as the `User` model and `app.blade.php` layout. Otherwise, the generated tests may have failures.*

Documentation
-------------

[](#documentation)

Browse the [Blueprint Docs](https://blueprint.laravelshift.com/) for full details on [defining models](https://blueprint.laravelshift.com/docs/defining-models/), [defining controllers](https://blueprint.laravelshift.com/docs/defining-controllers/), [advanced configuration](https://blueprint.laravelshift.com/docs/advanced-configuration/), and [extending Blueprint](https://blueprint.laravelshift.com/docs/extending-blueprint/).

Support Policy
--------------

[](#support-policy)

Starting with version 2, Blueprint only generates code for supported versions of Laravel (currently Laravel 11 or higher). If you need to support older versions of Laravel, you may constrain Blueprint to an older version or upgrade your application ([try using Shift](https://laravelshift.com)).

Blueprint still follows [semantic versioning](https://semver.org/). However, it does so with respect to its grammar. Any changes to the grammar will increase its major version number. Otherwise, minor version number increases will contain new features. This includes generating code for future versions of Laravel.

###  Health Score

69

—

FairBetter than 100% of packages

Maintenance77

Regular maintenance activity

Popularity69

Solid adoption and visibility

Community47

Growing community involvement

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 68.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~29 days

Recently: every ~152 days

Total

76

Last Release

186d ago

Major Versions

0.5.1 → 1.0.02019-12-02

v1.25.0 → v2.0.02021-08-17

### Community

Maintainers

![](https://www.gravatar.com/avatar/92a6bfc994b500ee991e6a7c581fb07af26b68b85821ff354bed0ac786fc9211?d=identicon)[jasonmccreary](/maintainers/jasonmccreary)

---

Top Contributors

[![jasonmccreary](https://avatars.githubusercontent.com/u/161071?v=4)](https://github.com/jasonmccreary "jasonmccreary (277 commits)")[![Pr3d4dor](https://avatars.githubusercontent.com/u/13210429?v=4)](https://github.com/Pr3d4dor "Pr3d4dor (16 commits)")[![ghostwriter](https://avatars.githubusercontent.com/u/9754361?v=4)](https://github.com/ghostwriter "ghostwriter (14 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (14 commits)")[![nicodevs](https://avatars.githubusercontent.com/u/3766839?v=4)](https://github.com/nicodevs "nicodevs (13 commits)")[![benjam-es](https://avatars.githubusercontent.com/u/1738602?v=4)](https://github.com/benjam-es "benjam-es (11 commits)")[![devmsh](https://avatars.githubusercontent.com/u/9499808?v=4)](https://github.com/devmsh "devmsh (8 commits)")[![promatik](https://avatars.githubusercontent.com/u/1838187?v=4)](https://github.com/promatik "promatik (5 commits)")[![jyrkidn](https://avatars.githubusercontent.com/u/2447042?v=4)](https://github.com/jyrkidn "jyrkidn (4 commits)")[![bingtsingw](https://avatars.githubusercontent.com/u/10382462?v=4)](https://github.com/bingtsingw "bingtsingw (3 commits)")[![nexxai](https://avatars.githubusercontent.com/u/4316564?v=4)](https://github.com/nexxai "nexxai (3 commits)")[![spaceemotion](https://avatars.githubusercontent.com/u/429147?v=4)](https://github.com/spaceemotion "spaceemotion (3 commits)")[![adevade](https://avatars.githubusercontent.com/u/1066486?v=4)](https://github.com/adevade "adevade (3 commits)")[![dmason30](https://avatars.githubusercontent.com/u/20278756?v=4)](https://github.com/dmason30 "dmason30 (3 commits)")[![axit-joost](https://avatars.githubusercontent.com/u/13835397?v=4)](https://github.com/axit-joost "axit-joost (3 commits)")[![YannikFirre](https://avatars.githubusercontent.com/u/3316758?v=4)](https://github.com/YannikFirre "YannikFirre (2 commits)")[![diogogomeswww](https://avatars.githubusercontent.com/u/11543163?v=4)](https://github.com/diogogomeswww "diogogomeswww (2 commits)")[![justinwhite15](https://avatars.githubusercontent.com/u/841517?v=4)](https://github.com/justinwhite15 "justinwhite15 (2 commits)")[![LorenzoPapi](https://avatars.githubusercontent.com/u/42911751?v=4)](https://github.com/LorenzoPapi "LorenzoPapi (2 commits)")[![matt-h](https://avatars.githubusercontent.com/u/664294?v=4)](https://github.com/matt-h "matt-h (2 commits)")

---

Tags

frameworklaravelcode-generation

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/laravel-shift-blueprint/health.svg)

```
[![Health](https://phpackages.com/badges/laravel-shift-blueprint/health.svg)](https://phpackages.com/packages/laravel-shift-blueprint)
```

###  Alternatives

[laravel/ui

Laravel UI utilities and presets.

2.7k134.9M601](/packages/laravel-ui)[laravel/passport

Laravel Passport provides OAuth2 server support to Laravel.

3.4k85.0M532](/packages/laravel-passport)[laravel/sail

Docker files for running a basic Laravel application.

1.9k186.9M1.0k](/packages/laravel-sail)[laravel-zero/framework

The Laravel Zero Framework.

3371.4M369](/packages/laravel-zero-framework)[laravel/lumen-framework

The Laravel Lumen Framework.

1.5k26.2M709](/packages/laravel-lumen-framework)[graham-campbell/markdown

Markdown Is A CommonMark Wrapper For Laravel

1.3k7.1M64](/packages/graham-campbell-markdown)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)