PHPackages viewflex/ligero - 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. [API Development](/categories/api) 4. / 5. viewflex/ligero ActiveLibrary[API Development](/categories/api) viewflex/ligero =============== A Laravel BREAD micro-framework supporting rapid modeling of domains with UI and API controllers, multiple view modes, advanced search, pagination, presenters, localization and caching. 1.1.4(6y ago)2221MITPHPCI failing Since Nov 22Pushed 6y ago1 watchersCompare [ Source](https://github.com/viewflex/ligero)[ Packagist](https://packagist.org/packages/viewflex/ligero)[ RSS](/packages/viewflex-ligero/feed)WikiDiscussions master Synced yesterday READMEChangelogDependencies (1)Versions (10)Used By (1) Ligero ====== [](#ligero) [![GitHub license](https://camo.githubusercontent.com/850eae1099d2b05f53383473d7cd51f9bc1ab09b7d0d9e5122f1dd930efdcc6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6173686170652f6170697374617475732e737667)](LICENSE.md) QuickStart ---------- [](#quickstart) A Laravel BREAD micro-framework supporting rapid modeling of domains with UI and API controllers, multiple view modes, advanced search, pagination, presenters, localization and caching. QuickStart | [Configuration](https://github.com/viewflex/ligero-docs/blob/master/CONFIGURATION.md) | [Advanced Usage](https://github.com/viewflex/ligero-docs/blob/master/ADVANCED.md) - [Installation](#installation) - [Overview](#overview) - [Basic Usage](#basic-usage) - [Customization](#customization) - [Tests](#tests) - [License](#license) - [Changelog](#changelog) - [Contributing](#contributing) ### Installation [](#installation) From your Laravel application's root directory, install using Composer: ``` $ composer require viewflex/ligero ``` Add the `LigeroServiceProvider` to the list of providers in Laravel's `config/app.php` file. ``` Viewflex\Ligero\LigeroServiceProvider::class, ``` ### Overview [](#overview) The goal is to provide a versatile, extensible BREAD (Browse-Read-Edit-Add-Delete) micro-framework that can be easily understood and deployed, while integrating all the necessary class types, following SOLID design principles, and enabling rapid modeling of domains. BREAD operations and generation of dynamic controls are performed via a **Publisher** object, which serves a particular representation of a business or application domain. A Publisher encapsulates a distinct set of components, representing configuration, request, and repository - through configuration of these components we customize a Publisher for the required tasks. This package combines an elegant interface for creating, configuring and using Publishers, with a modular architecture that allows enhancement of all components via extension or decoration. With scaffolding for Publisher controllers and contexts, it provides a path for implementing both simple BREAD functionality and complex multi-domain applications and services. This documentation, along with the included demo, shows various ways to implement a Publisher in real-world applications, but in it's simplest form, this one line creates a configured Publisher which returns a data bundle containing the requested results and UI data: ``` $data = (new Publisher($config, $request))->getData(); ``` #### Managing Complexity [](#managing-complexity) Let's face it, implementing even simple BREAD involves more than just calling a few Eloquent methods. As it turns out, though, much of the code, even for complex multi-domain applications, can be broken out into standard components for reuse. This package attempts to abstract as much of the functionality as possible to support easy declarative configuration of a domain Publisher or Context, allowing quick prototyping of domains and service layers. #### Architecture [](#architecture) The assembly of various class types follows the **Strategy Pattern**, and provides all the necessary functionality for processing BREAD requests, returning raw or presented results, and generating dynamic contextual data for UI controls. [![publisher flow](https://raw.githubusercontent.com/viewflex/ligero-docs/master/img/publisher-flow.png)](https://raw.githubusercontent.com/viewflex/ligero-docs/master/img/publisher-flow.png) This pattern is easy to replicate for each domain, enabling rapid scaffolding of an application with many domains. The included demo illustrates deployment of both UI and API controllers, using the example *Items* domain. The demo also includes an example of a Context (in the DDD sense of the word), which encapsulates a Publisher and it's components. A good place to start understanding any codebase is through the [interfaces](https://github.com/viewflex/ligero/tree/master/src/Contracts). In this package nearly every class implements an interface, providing a clear map of core functionality, and a decoupling of code that allows extension, decoration, or replacement of any class, without side-effects. It's not necessary to learn about every component before you start using this package - all configuration can be done fluently without extending or decorating classes. See the following sections to get up and running quickly with your own custom BREAD domains. #### Getting Started [](#getting-started) This package provides several ways to create and deploy a domain Publisher, depending on the complexity of the requirements for a given domain. See [Basic Usage](#basic-usage) (below) and the [Advanced Usage](https://github.com/viewflex/ligero-docs/blob/master/ADVANCED.md) documentation for examples. ### Basic Usage [](#basic-usage) Because this package was designed for maximum extensibility, there are many different ways in which it can be used. Typically you will implement a Publisher in a UI controller or an API controller with at least the basic BREAD methods as endpoints for the routes. The example below illustrates creation of a stateful UI controller serving a domain Publisher. See the [Advanced Usage](https://github.com/viewflex/ligero-docs/blob/master/ADVANCED.md) documentation to learn how the demo also makes use of the built-in API controller. #### The *Items* Demo [](#the-items-demo) There are multiple ways to implement a Publisher - let's begin by looking at the demo UI controller. [![demo screenshot](https://raw.githubusercontent.com/viewflex/ligero-docs/master/img/screenshots/results-list-view.png)](https://raw.githubusercontent.com/viewflex/ligero-docs/master/img/screenshots/results-list-view.png) The *Items* UI pictured above is part of the demo provided in this package; you can try it out using the [demo UI routes](#demo-ui-routes) listed below. It implements a BREAD UI with three view modes and an input form for create/edit operations. The templates are all plain HTML with Bootstrap.css, but the generated data that is displayed could just as easily be presented using any front-end framework. This package separates presentation from the application logic, generating results with all necessary data elements for dynamic UI components, pre-packaged in a standardized format (use the 'Items > Display as JSON' menu command to see the raw data). ##### Using the Demo as a Template [](#using-the-demo-as-a-template) See the [Publishing the Package Files](#publishing-the-package-files) subsection below to learn how to quickly scaffold new domains by publishing (copying) the demo and customizing it to suit the requirements. ##### Demo UI Controller [](#demo-ui-controller) We start with a new controller extending `BasePublisherController`, to inherit the session-aware BREAD actions and generated UI controls. In the constructor we create a default Publisher and then override the default values as needed using fluent setter methods (see the [Configuration](https://github.com/viewflex/ligero-docs/blob/master/CONFIGURATION.md) documentation for a complete list). ``` namespace Viewflex\Ligero\Publish\Demo\Items; use Viewflex\Ligero\Base\BasePublisherController; class ItemsController extends BasePublisherController { public function __construct() { $this->createPublisherWithDefaults(); $this ->setDomain('Items') ->setTranslationFile('items') ->setTableName('ligero_items') ->setModelName('Viewflex\Ligero\Publish\Demo\Items\Item') ->setResultsColumns([ 'id', 'active', 'name', 'category', 'subcategory', 'description', 'price' ]) ->setWildcardColumns([ 'category' ]) ->setControls([ 'pagination' => true, 'keyword_search' => true ]) ->setKeywordSearchColumns([ 'name', 'category', 'subcategory', 'description' ]) ->setQueryRules([ 'active' => 'boolean', 'name' => 'max:60', 'category' => 'max:25', 'subcategory' => 'max:25' ]) ->setRequestRules([ 'active' => 'boolean', 'name' => 'max:60', 'category' => 'max:25', 'subcategory' => 'max:25', 'description' => 'max:250', 'price' => 'numeric' ]); } } ``` ##### Demo UI Routes [](#demo-ui-routes) In Laravel, a resourceful controller's routes can be specified with one line, but by using explicit routes, as shown below, we can ensure that the route parameter name is always `{id}`, as the codebase expects. Laravel would otherwise automatically use the singular form of the model name. Additional routes should be declared first. These two add some special functions to the BREAD layer of the *Items* domain: ``` Route::get('ligero/items/json', array('as' => 'ligero.items.json', 'uses' => '\Viewflex\Ligero\Publish\Demo\Items\ItemsController@json', 'middleware' => 'web')); Route::get('ligero/items/action', array('as' => 'ligero.items.action', 'uses' => '\Viewflex\Ligero\Publish\Demo\Items\ItemsController@action', 'middleware' => 'web')); ``` These are the standard resource controller routes for the *Items* demo domain: ``` Route::get('ligero/items', array('as' => 'ligero.items.index', 'uses' => '\Viewflex\Ligero\Publish\Demo\Items\ItemsController@index', 'middleware' => 'web')); Route::get('ligero/items/create', array('as' => 'ligero.items.create', 'uses' => '\Viewflex\Ligero\Publish\Demo\Items\ItemsController@create', 'middleware' => 'web')); Route::get('ligero/items/{id}', array('as' => 'ligero.items.show', 'uses' => '\Viewflex\Ligero\Publish\Demo\Items\ItemsController@show', 'middleware' => 'web')); Route::get('ligero/items/{id}/edit', array('as' => 'ligero.items.edit', 'uses' => '\Viewflex\Ligero\Publish\Demo\Items\ItemsController@edit', 'middleware' => 'web')); Route::post('ligero/items/store', array('as' => 'ligero.items.store', 'uses' => '\Viewflex\Ligero\Publish\Demo\Items\ItemsController@store', 'middleware' => 'web')); Route::put('ligero/items/{id}', array('as' => 'ligero.items.update', 'uses' => '\Viewflex\Ligero\Publish\Demo\Items\ItemsController@update', 'middleware' => 'web')); Route::delete('ligero/items/{id}', array('as' => 'ligero.items.destroy', 'uses' => '\Viewflex\Ligero\Publish\Demo\Items\ItemsController@destroy', 'middleware' => 'web')); ``` ##### Demo API Routes [](#demo-api-routes) Besides the UI controller used in the demo, this package also includes a Context and API controller serving the API routes for the same *Items* domain. See the [Advanced Usage](https://github.com/viewflex/ligero-docs/blob/master/ADVANCED.md) documentation to understand how API calls are routed. #### Thinking Beyond BREAD [](#thinking-beyond-bread) Now that you see how easy it is to implement a Publisher, you may be wondering how they can be used in the wider context of the application under development. If you are thinking along the lines of Domain-Driven Design (DDD) in designing your application, see the [Advanced Usage](https://github.com/viewflex/ligero-docs/blob/master/ADVANCED.md) documentation to understand the built-in support for bounded contexts. ### Customization [](#customization) This package comes with a demo domain that provides examples of publishing a domain with both a UI controller and an API controller. To install an editable copy of the demo *Items* domain to use as boilerplate for a new domain, just run the `publish` command with the `ligero` tag, run the migration, and seed the demo database table, as described below. Copy and rename the demo files you need and change the class names. Copy and rename the resource files (views and lang), and customize as needed. Create and seed new database tables as needed. #### Publishing the Package Files [](#publishing-the-package-files) The package service provider configures `artisan` to publish specific file groups with tags. There are several options available. ##### Routes [](#routes) Run this command to publish the `routes.php` file to the project's `publish/viewflex/ligero` directory: ``` php artisan vendor:publish --tag='ligero-routes' ``` ##### Config [](#config) Run this command to publish the `ligero.php` config file to the project's `config` directory for customization: ``` php artisan vendor:publish --tag='ligero-config' ``` ##### Resources [](#resources) Run this command to publish the blade templates for the demo UI, and lang files for package messages and UI strings: ``` php artisan vendor:publish --tag='ligero-resources' ``` ##### Routes, Demo Migration and Seeder [](#routes-demo-migration-and-seeder) Run this command to install the migration and seeder for the 'Items' demo domain: ``` php artisan vendor:publish --tag='ligero-data' ``` After publishing the demo migration and seeder, run the migration: ``` php artisan migrate ``` Then run the seeder: ``` php artisan db:seed --class="LigeroSeeder" ``` ##### Routes, Config, Resources, Demo Migration and Seeder [](#routes-config-resources-demo-migration-and-seeder) Use this command to publish config, demo views, and lang files for modification. The demo migration and seeder are also copied to their proper directories: ``` php artisan vendor:publish --tag='ligero' ``` #### Extending or Decorating Base Classes [](#extending-or-decorating-base-classes) Ligero's architecture is based on a distinct pattern of class types, each defined by an interface; since classes relate to each other as abstract types, you can easily substitute your own custom classes, provided that they implement the same interfaces. #### Namespace for Custom Classes [](#namespace-for-custom-classes) The `Viewflex\Ligero\Publish` namespace, corresponding to the `publish/viewflex/ligero` directory, is recognized by the package, and is intended for organization of your custom classes. The *Items* demo classes will be published (copied) to this directory for customization, along with the demo routes file. ### Tests [](#tests) The phpunit tests can be run as described in the [Test Documentation](https://github.com/viewflex/ligero-docs/blob/master/TESTS.md). ### License [](#license) This software is offered for use under the [MIT License](LICENSE.md). ### Changelog [](#changelog) Release versions are tracked in the [Changelog](https://github.com/viewflex/ligero-docs/blob/master/CHANGELOG.md). ### Contributing [](#contributing) Please see the [Contributing Guide](https://github.com/viewflex/ligero-docs/blob/master/CONTRIBUTING.md) to learn more about the project goals and how you can help. ### Health Score 30 — LowBetter than 64% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community9 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor1 Top contributor holds 100% 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 ~103 days Recently: every ~170 days Total 8 Last Release 2373d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/4b93f8b0a642b06fab7cd680ba7a56539f9b77e5c09fae9f26bfcc319128d794?d=identicon)[viewflex](/maintainers/viewflex) --- Top Contributors [![viewflex](https://avatars.githubusercontent.com/u/6198916?v=4)](https://github.com/viewflex "viewflex (36 commits)") --- Tags apilaravelscaffoldpaginationContextcrudDomain Driven Designbreadddd ### Embed Badge ![Health badge](/badges/viewflex-ligero/health.svg) ``` [![Health](https://phpackages.com/badges/viewflex-ligero/health.svg)](https://phpackages.com/packages/viewflex-ligero) ``` ### Alternatives [yxx/laravel-quick agile development 145.3k](/packages/yxx-laravel-quick) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)