PHPackages                             libaro/bread - 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. libaro/bread

ActiveLibrary

libaro/bread
============

Bread

1.5.3(3y ago)8411[5 PRs](https://github.com/libaro-io/Bread/pulls)MITVuePHP ^7.4|^8.0

Since Jul 5Pushed 2y ago2 watchersCompare

[ Source](https://github.com/libaro-io/Bread)[ Packagist](https://packagist.org/packages/libaro/bread)[ Docs](https://github.com/libaro-io/Bread)[ RSS](/packages/libaro-bread/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (5)Versions (19)Used By (0)

Bread
=====

[](#bread)

[![Latest Version on Packagist](https://camo.githubusercontent.com/911cad2728747107dda5b5ec43b354e3322294283a7d3ebaf1ec679d412a9388/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c696261726f2f62726561642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/libaro/bread)[![GitHub Tests Action Status](https://camo.githubusercontent.com/b682f2910c0b8d37e7c392bb9bb0abc091214f6ae6fc18e0741373bc70fe5045/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6c696261726f2d696f2f42726561642f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/libaro-io/Bread/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/a52dcc16f9cfb69097758780e59f4ec214949f45816fd83d1e6a66f88af6d83b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6c696261726f2d696f2f42726561642f436865636b253230262532306669782532307374796c696e673f6c6162656c3d636f64652532307374796c65)](https://github.com/libaro-io/Bread/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/bb3a358d10a3dff1ac1ffa871b15cb23c05821183c459ed2c136f874f78f1bb1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c696261726f2f62726561642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/libaro/bread)

What is Bread?
--------------

[](#what-is-bread)

Bread stands for Browse, Read, Edit, Add and Delete. It allows the developer to rapidly create CRUD applications, simply by describing which fields to use.

The full documentation is installed with the package under `/docs`

Bread is a Laravel package to be used in combination with Inertia, Tailwind and Vue. So be sure to have these installed and configured.

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

[](#installation)

```
composer require libaro/bread
```

Publish resource files
----------------------

[](#publish-resource-files)

Run following command to publish the javascript files needed to render the index and form pages.

```
php artisan vendor:publish --tag=bread --force
```

This will add the following to your project:

```
/Bread
  /Resources
    /js
    /ui

```

You can customize the published files and add your own components in the `Bread/Resources` directory.

### Update your inertia app

[](#update-your-inertia-app)

Update your inertia app to include the following:

```
createInertiaApp({
  resolve: (name) => {
    const [domain, path] = name.split('::')

    let page = null

    if (domain === 'Bread') {
      page = require(`./../../../Bread/Resources/ui/Pages/${path}.vue`).default
    } else {
      page = require(`./../../../resources/admin/ui/Pages/${domain}/${path}.vue`).default
    }

    page.layout ??= Backend

    return page
  },
  ...
})
```

This allows the use of `{domain}::{page}` when calling an Inertia Page (e.g.: `Bread::Index`).

### Add the '@bread' alias to your webpack config file

[](#add-the-bread-alias-to-your-webpack-config-file)

```
const path = require('path')

module.exports = {
  optimization: {
    minimize: false,
  },
  resolve: {
    alias: {
      '@bread': path.resolve('Bread/Resources')
    }
  }
}
```

Dependencies
------------

[](#dependencies)

Bread requires the following dependencies, be sure to install these in your project:

```
npm install -D tailwindcss@^3.1 postcss autoprefixer vue@^3.2 @inertiajs/inertia@^0.11.0 @inertiajs/inertia-vue3@^0.6.0 unplugin-vue-define-options@^0.6.1 @tailwindcss/forms@^0.4.0 @headlessui/vue@^1.6 pinia@^2.0.0 uuid@^8.3.2 luxon@^2.4.0
```

```
composer require tightenco/ziggy
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](https://github.com/libaro-io/.github/blob/main/CONTRIBUTING.md) for details.

Development Flow
----------------

[](#development-flow)

Please see [DEVELOPMENT FLOW](https://github.com/libaro-io/.github/blob/main/DEVELOPMENT_FLOW.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Libaro](https://github.com/libaro-io)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 71.9% 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 ~2 days

Total

11

Last Release

1389d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9e1c94032186d05b780397bbc41c70bff8c561081df10719546a92de8dfd9498?d=identicon)[Libaro](/maintainers/Libaro)

---

Top Contributors

[![johan-libaro](https://avatars.githubusercontent.com/u/102519307?v=4)](https://github.com/johan-libaro "johan-libaro (69 commits)")[![Libaro-Jens](https://avatars.githubusercontent.com/u/108721346?v=4)](https://github.com/Libaro-Jens "Libaro-Jens (9 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (7 commits)")[![TimLibaro](https://avatars.githubusercontent.com/u/77798606?v=4)](https://github.com/TimLibaro "TimLibaro (3 commits)")

---

Tags

laravelbreadvuetailwindcsslibaro

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/libaro-bread/health.svg)

```
[![Health](https://phpackages.com/badges/libaro-bread/health.svg)](https://phpackages.com/packages/libaro-bread)
```

###  Alternatives

[badaso/core

The API &amp; platform builder, build your apps 10x faster even more, it's open source &amp; 100% free !

1.3k16.2k10](/packages/badaso-core)[titasgailius/laravel-moonlight

An elegant Laravel scaffolding for your next single-page application.

1446.6k](/packages/titasgailius-laravel-moonlight)[yieldstudio/tailwind-merge-php

Merge Tailwind CSS classes without style conflicts

4972.8k1](/packages/yieldstudio-tailwind-merge-php)[kamona/kui-laravel-fortify

Front-end scafolding for laravel/fortify based on kui-dashboard

132.7k](/packages/kamona-kui-laravel-fortify)[electrik/slate

Slate - a Laravel Blade UI Kit is a set of anonymous blade components built using TailwindCSS v4 with built-in dark mode support for your next Laravel project

102.3k1](/packages/electrik-slate)

PHPackages © 2026

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