This repository is the documentation hub for the Liberu ecosystem: Laravel applications, independent domain modules, APIs, presentation adapters, themes, engineering standards, deployment, and product scopes.
If you are new, start with GETTING-STARTED.md. If you already know the solution or technology you need, use the indexes below.
| You want to… | Start here |
|---|---|
| Understand the whole Liberu platform | Liberu platform scope · Technology and solution map |
| Read what an installed product feels like to an end user | End-user interface guides · Web and mobile standard |
| Build a new application or package | Modules · Laravel standard · Coding guidelines |
| Find a product capability | Application scopes · Feature indexes |
| Add an API or UI adapter | API index · Presentation indexes |
| Choose React, Vue, Nuxt, Livewire, Filament, React Native, or Flutter | Technology standards · Technology map |
| Design or extend a theme | Theme standard |
| Run tests, CI, or a release | Testing · CI · Deployment |
| Contribute or report a vulnerability | Contributing · Security |
Liberu separates concerns so the same domain capability can be used by multiple applications and interfaces:
Application composition
↓
Domain module → API contract → web or mobile presentation adapter
↓ ↓
Persistence, policies, events Theme and design-system adapter
- Architecture records boundaries and decisions: architecture/README.md, modules, API contracts, tenancy, teams, policies, repositories, and security.
- Standards define implementation quality: standards/README.md, coding, PHP, Laravel, frontend frameworks, database, themes, testing, documentation, and operations.
- Technologies provide language references: technologies/README.md, JavaScript, TypeScript, PHP, and the root technology map.
- Projects define product and application scope. Feature documents are framework-neutral; API and presentation documents are optional one-to-one adapters.
Use the latest stable versions supported by the ecosystem and the consuming repository’s lock file and CI matrix. The current documentation baseline is PHP 8.5, Laravel 13, Filament 5, Livewire 4, React 19.2, Inertia 3, Vue 3, Nuxt 4, and Node.js 22+.
| Technology | Liberu standard | Official documentation |
|---|---|---|
| PHP and PSR | PHP · PSR · Pint | PHP · PHP-FIG |
| Laravel | Laravel | Laravel 13 docs · Laravel GitHub |
| Filament | Filament | Filament 5 docs · GitHub |
| Livewire | Livewire | Documentation · GitHub |
| React | React | React docs · GitHub |
| Inertia | Inertia | Inertia 3 docs · GitHub |
| Vue | Vue | Vue docs · GitHub |
| Nuxt | Nuxt | Nuxt 4 docs · GitHub |
| JavaScript and TypeScript | JavaScript · TypeScript | MDN · TypeScript |
Each application scope identifies its domain modules and links to the corresponding API and presentation indexes. See the complete projects index.
| Application | Modules | API | Filament | Livewire | React | Vue | Nuxt | React Native | Flutter |
|---|---|---|---|---|---|---|---|---|---|
| Boilerplate foundation | 28 | 28 | 28 | 28 | 28 | 28 | 28 | 28 | 28 |
| Accounting | 105 | 105 | 105 | 105 | 105 | 105 | 105 | 105 | 105 |
| Automation | 11 | 11 | 11 | 11 | 11 | 11 | 11 | 11 | 11 |
| Billing | 16 | 16 | 16 | 16 | 16 | 16 | 16 | 16 | 16 |
| Browser Game | 15 | 15 | 15 | 15 | 15 | 15 | 15 | 15 | 15 |
| CMS | 81 | 81 | 81 | 81 | 81 | 81 | 81 | 81 | 81 |
| Control Panel | 15 | 15 | 15 | 15 | 15 | 15 | 15 | 15 | 15 |
| CRM | 95 | 95 | 95 | 95 | 95 | 95 | 95 | 95 | 95 |
| Ecommerce | 105 | 105 | 105 | 105 | 105 | 105 | 105 | 105 | 105 |
| Genealogy | 14 | 14 | 14 | 14 | 14 | 14 | 14 | 14 | 14 |
| Maintenance | 14 | 14 | 14 | 14 | 14 | 14 | 14 | 14 | 14 |
| Real Estate | 15 | 15 | 15 | 15 | 15 | 15 | 15 | 15 | 15 |
| SAP-style Enterprise Suite | 16 | 16 | 16 | 16 | 16 | 16 | 16 | 16 | 16 |
| Social Network | 15 | 15 | 15 | 15 | 15 | 15 | 15 | 15 | 15 |
The Modules column links each application's framework-neutral module index. Every application publishes that index under features/, except the boilerplate foundation, which publishes it under core/ because it defines application foundations rather than domain features.
The Liberu platform adds only new cross-product capabilities under projects/liberu/features: Platform Orchestration, Executive Insights, and Business Workflow Reconciliation, with matching API, Filament, Livewire, React, Vue, Nuxt, React Native, and Flutter indexes.
These root indexes cover the complete existing module matrix. Select only the adapters needed by an application surface.
- Feature specifications — framework-neutral domain capability.
- Module indexes · Generic domain feature scopes — domain-to-implementation mapping.
- API modules — HTTP/API contracts and adapters.
- Filament implementations — administrative and operational UI.
- Livewire implementations — server-driven Laravel UI.
- React + Inertia implementations — React application UI over Laravel routes.
- Vue + Inertia implementations — Vue application UI over Laravel routes.
- Nuxt implementations — Vue SSR/API-consuming applications.
- React Native + Expo implementations — iOS and Android clients.
- Flutter implementations — Dart/Flutter clients for mobile and other supported platforms.
- Read GETTING-STARTED.md for the recommended workflow.
- Use DATABASE.md for migrations, seeders, factories, ownership, and database operations.
- Use TRANSLATIONS.md for localization ownership, catalogs, formatting, and RTL behavior.
- Use deployment documentation for Docker, Kubernetes, web servers, queues, workers, and observability.
- Update the relevant source-of-truth document in the same change as code or contract changes.
- Keep examples safe: never commit secrets, production data, or private identifiers.