PHPackages liberusoftware/boilerplate-laravel - 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. liberusoftware/boilerplate-laravel ActiveProject[Framework](/categories/framework) liberusoftware/boilerplate-laravel ================================== Liberu boilerplate Laravel application. v4.4.0(today)1951↑2900%53[1 issues](https://github.com/liberusoftware/boilerplate-laravel/issues)MITPHPPHP ^8.5CI passing Since Mar 11Pushed today10 watchersCompare [ Source](https://github.com/liberusoftware/boilerplate-laravel)[ Packagist](https://packagist.org/packages/liberusoftware/boilerplate-laravel)[ GitHub Sponsors](https://github.com/liberusoftware)[ RSS](/packages/liberusoftware-boilerplate-laravel/feed)WikiDiscussions main Synced today READMEChangelog (8)Dependencies (86)Versions (74)Used By (0) Liberu Boilerplate ================== [](#liberu-boilerplate) > Production-ready Laravel foundation for modular, single-tenant and multi-tenant applications. [Software](https://liberusoftware.com) · [Hosting](https://liberuhosting.com) · [Services](https://liberuservices.com) · [Liberu Group](https://liberugroup.com) [![PHP](https://camo.githubusercontent.com/38189c74fa19d38a84282702897dcd5bf0e54f8ee6be5cb02aa9a3a1f5711862/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e352d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/) [![Laravel](https://camo.githubusercontent.com/2b0ecb5e5f9e75864d7ea39cbc2e1f0100d1f048b015b74a8cf2edb8f11752f1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31332d4646324432303f6c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://laravel.com/) [![Filament](https://camo.githubusercontent.com/6369ea05721c12d4390b61b2f0d5c24376111ba48c40f638f24f175d79709cf6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46696c616d656e742d352d464441453442)](https://filamentphp.com/) [![Livewire](https://camo.githubusercontent.com/f3f91c30bf1cad9f063fc7949647ae429dcd695e0f86ebc0afcc55bf1da9448e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c697665776972652d342d464237304139)](https://livewire.laravel.com/) [![Install](https://github.com/liberusoftware/boilerplate-laravel/actions/workflows/install.yml/badge.svg?branch=main)](https://github.com/liberusoftware/boilerplate-laravel/actions/workflows/install.yml) [![Tests](https://github.com/liberusoftware/boilerplate-laravel/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/liberusoftware/boilerplate-laravel/actions/workflows/tests.yml) [![Docker](https://github.com/liberusoftware/boilerplate-laravel/actions/workflows/docker.yml/badge.svg?branch=main)](https://github.com/liberusoftware/boilerplate-laravel/actions/workflows/docker.yml) [![Codecov](https://camo.githubusercontent.com/a74631f114fce7b72ca5cdff1c484fe9a407d08e0dbe2650c031b76b0f0eeeca/68747470733a2f2f636f6465636f762e696f2f67682f6c6962657275736f6674776172652f626f696c6572706c6174652d6c61726176656c2f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/liberusoftware/boilerplate-laravel) [![Latest release](https://camo.githubusercontent.com/137a8ed330b64165227222c2171c98015ca637559564bbfc072d4413a6a7d537/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6c6962657275736f6674776172652f626f696c6572706c6174652d6c61726176656c3f736f72743d73656d766572)](https://github.com/liberusoftware/boilerplate-laravel/releases/latest) [![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](LICENSE.md) Liberu Boilerplate is the deployable reference host for the Liberu Composer ecosystem. It combines independently released capability, presentation, and theme packages while keeping application bootstrapping, environment configuration, panel composition, and cross-package tests in one place. Key features ------------ [](#key-features) - Jetstream authentication, profiles, sessions, two-factor authentication, passkeys, and social login - Filament admin and account panels assembled from optional presentation modules - Organisations, teams, roles, permissions, audit trails, settings, and feature flags - Messaging, notifications, localisation, search, files, webhooks, integrations, analytics, and import/export foundations - Queue, scheduler, Horizon, Pulse, Telescope, Octane, Reverb, backup, and observability support - Independently versioned modules installed into tracked `/modules` directories - Independently versioned themes installed into tracked `/themes` directories with inheritance and safe fallback - Architecture tests for manifests, dependency direction, package ownership, and presentation boundaries Requirements ------------ [](#requirements) DependencySupported versionPHP8.5Laravel13.xFilament5.xLivewire4.xComposer2.xNode.jsLatest stable releaseDatabaseA Laravel-supported SQL databaseQuick start ----------- [](#quick-start) ``` git clone https://github.com/liberusoftware/boilerplate-laravel.git cd boilerplate-laravel composer install cp .env.example .env php artisan key:generate npm install npm run build php artisan migrate php artisan serve ``` Review `.env` before migrating. Use `php artisan migrate --seed` only when example data is wanted. The optional interactive `install.sh` supports local, Docker, and Kubernetes-oriented setup. Composable package architecture ------------------------------- [](#composable-package-architecture) Each runtime capability is an independent `liberu-module` Composer package with its own GitHub repository, release lifecycle, manifest, provider, documentation, and tests. Each visual package is an independent `liberu-theme`. Shared contract packages and the custom installer are normal Composer dependencies under `/vendor`. ``` Application composition ├── modules/ # Composer-installed module releases, tracked in Git ├── themes/ # Composer-installed theme releases, tracked in Git ├── app/ # Host-only composition and integration ├── config/ # Enabled modules and application policy └── tests/ # Cross-package and application tests ``` Composer is the source of installation and version truth: ``` # Update all dependencies, including modules and themes composer update --with-all-dependencies # Update one capability from its tagged GitHub repository composer update liberusoftware/search --with-dependencies ``` The trusted [`liberusoftware/composer-installer`](https://github.com/liberusoftware/composer-installer) places packages according to type: Composer typeInstall pathRepository convention`liberu-module``/modules/{installer-name}``liberusoftware/module-{installer-name}``liberu-theme``/themes/{installer-name}``liberusoftware/theme-{installer-name}`Contract/library`/vendor`Package-specific repository`modules/` and `themes/` are intentionally kept out of `.gitignore`. Their reproduced contents are committed so deployments and reviews can see the exact installed code, while `composer.lock` pins each release and source commit. Do not edit an installed module only in this host: contribute the generic change to its package repository, release it, and update the Composer dependency here. Installation, runtime enablement, authorisation, and commercial entitlement are separate concerns. `config/modules.php` selects the enabled capability graph; the module manager validates dependencies and orders providers without scanning application classes manually. Every module also publishes a validated feature catalog in `module.json`. Hosts can inspect the complete catalog or search it without loading module internals: ``` php artisan module:features php artisan module:features health php artisan module:status application-core ``` Module and theme development ---------------------------- [](#module-and-theme-development) A module owns one cohesive capability and communicates through public contracts, actions, events, registries, or stable identifiers. Domain modules do not depend on Filament or themes; optional `*-filament`, `*-api`, and `*-livewire` packages provide presentation adapters. Every module contains: ``` composer.json module.json README.md LICENSE.md CHANGELOG.md src/ database/ or resources/ when required tests/ ``` Themes contain `composer.json`, `theme.json`, source assets, compatibility metadata, accessibility/fallback expectations, tests, documentation, and asset licensing information. See the [module development guide](docs/MODULE_DEVELOPMENT.md) and [theme architecture](docs/THEME_ARCHITECTURE.md). Testing and quality ------------------- [](#testing-and-quality) ``` composer validate --strict vendor/bin/pest vendor/bin/pint --test npm run build ``` The test suite exercises application behaviour and every installed module provider. Package architecture tests verify metadata, declared dependencies, host isolation, UI boundaries, and Composer ownership. ### Publishing the component repositories [](#publishing-the-component-repositories) The publishing helper derives repository names from directory names, using `module-` for entries in `modules/` and `theme-` for entries in `themes/`. It also handles this complete meta repository as `boilerplate-laravel`. ``` # Inspect all mappings without changing GitHub scripts/publish-components # Create any missing public repositories in the organisation scripts/publish-components --create # After committing the complete worktree, split and push every component plus the meta repository scripts/publish-components --push ``` Publishing requires authenticated `gh` and `git` access to the organisation. Push mode deliberately refuses a dirty worktree because subtree splits can only publish committed content. Existing repositories are updated without force, so non-fast-forward histories must be reconciled explicitly rather than overwritten. After the repositories are public, register every Composer package on Packagist: ``` # Verify all package-to-repository mappings without submitting php scripts/submit-packagist.php --dry-run # Obtain the MAIN API token from packagist.org/profile, then bulk register the packages export PACKAGIST_USERNAME='your-packagist-username' export PACKAGIST_API_TOKEN='your-packagist-api-token' php scripts/submit-packagist.php unset PACKAGIST_API_TOKEN ``` The submitter skips packages that are already registered and reports individual API failures without printing the configured token. Documentation ------------- [](#documentation) - [Module development](docs/MODULE_DEVELOPMENT.md) - [Foundation compliance](docs/FOUNDATION_COMPLIANCE.md) - [Foundation module matrix](docs/FOUNDATION_MODULE_MATRIX.md) - [Theme architecture](docs/THEME_ARCHITECTURE.md) - [Theme system](docs/THEME_SYSTEM.md) - [Messaging architecture](docs/MESSAGING_ARCHITECTURE.md) - [Search architecture](docs/SEARCH_ARCHITECTURE.md) - [Localisation](docs/MULTI_LANGUAGE.md) - [Notifications](docs/NOTIFICATIONS.md) Related Liberu projects ----------------------- [](#related-liberu-projects) ProjectRepositoryScopeAccounting[liberusoftware/accounting-erp-laravel](https://github.com/liberusoftware/accounting-erp-laravel)Ledgers, banking, tax, expenses, close, and reportingAutomation[liberusoftware/automation-laravel](https://github.com/liberusoftware/automation-laravel)Governed workflows, provider-neutral AI, approvals, and connectorsBilling[liberusoftware/billing-laravel](https://github.com/liberusoftware/billing-laravel)Billing, subscriptions, payments, invoices, and revenue operationsBoilerplate[liberusoftware/boilerplate-laravel](https://github.com/liberusoftware/boilerplate-laravel)Modular Laravel foundation and reference implementationBrowser game[liberusoftware/browser-game-laravel](https://github.com/liberusoftware/browser-game-laravel)Browser-based game platform and domain capabilitiesCMS[liberusoftware/cms-laravel](https://github.com/liberusoftware/cms-laravel)Content, publishing, pages, media, search, and deliveryControl panel[liberusoftware/control-panel-laravel](https://github.com/liberusoftware/control-panel-laravel)Hosting, infrastructure, DNS, mail, backups, and operationsCRM[liberusoftware/crm-laravel](https://github.com/liberusoftware/crm-laravel)Customers, leads, opportunities, sales, and serviceEcommerce[liberusoftware/ecommerce-laravel](https://github.com/liberusoftware/ecommerce-laravel)Catalogues, checkout, orders, fulfilment, and returnsGenealogy[liberusoftware/genealogy-laravel](https://github.com/liberusoftware/genealogy-laravel)Genealogy records, relationships, sources, and researchMaintenance[liberusoftware/maintenance-laravel](https://github.com/liberusoftware/maintenance-laravel)Maintenance planning, assets, work orders, and operationsReal estate[liberusoftware/real-estate-laravel](https://github.com/liberusoftware/real-estate-laravel)Property, listing, tenancy, and transaction workflowsSocial network[liberusoftware/social-network-laravel](https://github.com/liberusoftware/social-network-laravel)Social profiles, groups, content, messaging, and discoverySecurity -------- [](#security) Do not report security vulnerabilities through public GitHub issues. Email `security@liberusoftware.com` with reproduction details and the affected version so the report can be handled privately. License ------- [](#license) This project is open-source software available under the [MIT License](LICENSE.md). The linked licence text is authoritative; this summary is not legal advice. Feedback and contributing ------------------------- [](#feedback-and-contributing) Feedback and contributions are welcome. Report reproducible bugs, propose focused enhancements, improve documentation or translations, and submit tested changes. Search existing issues first. Pull requests should explain the problem and approach, remain focused, pass the required checks, and document user-visible or breaking changes. Security reports must follow the private route above. Contributors ------------ [](#contributors) Thank you to everyone who helps improve Liberu. [View the contributors graph](https://github.com/liberusoftware/boilerplate-laravel/graphs/contributors). ### Health Score 58 ↑ FairBetter than 98% of packages Maintenance100 Actively maintained with recent releases Popularity22 Limited adoption so far Community25 Small or concentrated contributor base Maturity74 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits 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 ~5 days Total 7 Last Release 0d ago Major Versions v2.0.0 → v3.0.02026-08-01 v3.1.0 → v4.1.02026-08-01 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/179251?v=4)[Curtis Delicata](/maintainers/curtisdelicata)[@curtisdelicata](https://github.com/curtisdelicata) --- Top Contributors [![curtisdelicata](https://avatars.githubusercontent.com/u/179251?v=4)](https://github.com/curtisdelicata "curtisdelicata (202 commits)")[![tdrabikdev](https://avatars.githubusercontent.com/u/82902162?v=4)](https://github.com/tdrabikdev "tdrabikdev (114 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (105 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (58 commits)")[![delicatacurtis](https://avatars.githubusercontent.com/u/247246500?v=4)](https://github.com/delicatacurtis "delicatacurtis (48 commits)")[![JoshKisb](https://avatars.githubusercontent.com/u/7253780?v=4)](https://github.com/JoshKisb "JoshKisb (16 commits)")[![sweep-ai-deprecated[bot]](https://avatars.githubusercontent.com/in/307814?v=4)](https://github.com/sweep-ai-deprecated[bot] "sweep-ai-deprecated[bot] (4 commits)")[![Madd-Floet](https://avatars.githubusercontent.com/u/110548795?v=4)](https://github.com/Madd-Floet "Madd-Floet (2 commits)")[![kaanucarci](https://avatars.githubusercontent.com/u/142806284?v=4)](https://github.com/kaanucarci "kaanucarci (1 commits)")[![liberugroup](https://avatars.githubusercontent.com/u/259175883?v=4)](https://github.com/liberugroup "liberugroup (1 commits)")[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (1 commits)") --- Tags boilerplateboilerplate-templatedockerfilamentfilamentphpjetstreamlaravellaravel11laravel12livewirelivewire3phpphp8php83tailwindtailwindcssframeworklaravelboilerplate ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/liberusoftware-boilerplate-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/liberusoftware-boilerplate-laravel/health.svg)](https://phpackages.com/packages/liberusoftware-boilerplate-laravel) ``` ### Alternatives [unopim/unopim UnoPim Laravel PIM 10.8k2.5k](/packages/unopim-unopim)[nasirkhan/laravel-starter A CMS like modular Laravel starter project. 1.4k2.7k](/packages/nasirkhan-laravel-starter)[bagisto/bagisto Bagisto Laravel E-Commerce 27.9k175.2k9](/packages/bagisto-bagisto)[typicms/base A modular multilingual CMS built with Laravel, enabling developers to manage structured content like pages, news, events, and more. 1.6k20.4k](/packages/typicms-base)[ercogx/laravel-filament-starter-kit This is a Filament v5 Starter Kit for Laravel 13, designed to accelerate the development of Filament-powered applications. 461.8k](/packages/ercogx-laravel-filament-starter-kit) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)