README

Liberu Automation

Automate smarter — build, deploy and manage Laravel workflows with zero friction.

About Liberu Automation

Liberu Automation is an open-source Laravel 12 application that gives teams a powerful, extensible platform for automating hosting, billing and operational workflows. Built on PHP 8.5, Filament 5 and Livewire 4, it delivers a rich admin interface out of the box — no paid plugins, no lock-in. Whether you are managing a single server or orchestrating a multi-tenant SaaS, Liberu Automation provides the foundation you need with the flexibility to adapt.

Main Features

Hosting control panel — ready-to-use primitives for managing users, teams, accounts and site settings across environments.
Billing automation — pre-built hooks, seeders and workflow triggers that slot into your existing payment and invoicing pipelines.
Filament 5 admin resources — polished, responsive admin panels generated from your Eloquent models with minimal boilerplate.
Livewire 4 components — reactive, real-time UI components that keep your UX snappy without writing custom JavaScript.
Pluggable modules architecture — add or remove feature modules without touching core logic; extend via service providers and events.
Docker & Sail ready — containerised from day one; spin up a full environment with a single command.
CI/CD workflows — bundled GitHub Actions for install, test and Docker image builds so your pipelines are ready immediately.
Comprehensive test suite — PHPUnit tests covering core workflows with Codecov integration for continuous coverage tracking.

Installation

Requirements

PHP 8.5+
Composer
Node.js (optional, for compiling front-end assets)
A supported database (MySQL, PostgreSQL or SQLite)

Option 1 — Automated installer (recommended)

The included setup.sh script walks you through the full setup interactively.

From the command line:

git clone https://github.com/liberu-automation/automation-laravel.git
cd automation-laravel
chmod +x setup.sh
./setup.sh

The script will prompt you to copy .env.example, confirm your database credentials, install Composer dependencies, generate the application key, run migrations and seeders, execute the test suite and optionally start the development server — all in one go.

Graphical installer (Linux desktop):

Right-click setup.sh in your file manager, choose Run as Program (or Execute in Terminal) and follow the on-screen prompts.

Option 2 — Manual setup

git clone https://github.com/liberu-automation/automation-laravel.git
cd automation-laravel
cp .env.example .env
# Edit .env and set your database credentials
composer install
php artisan key:generate
php artisan migrate --seed
php artisan serve

Option 3 — Docker

# Build and run as a single container
docker build -t automation-laravel .
docker run -p 8000:8000 automation-laravel

Option 4 — Laravel Sail (Docker Compose)

./vendor/bin/sail up -d

Our Projects

The Liberu ecosystem contains a number of companion repositories and packages that extend or demonstrate functionality used in this project. Follow the links below to learn more or to contribute.

Project	Repository	Description
Accounting	liberu-accounting/accounting-laravel	Accounting and invoicing features tailored for Laravel applications.
Automation	liberu-automation/automation-laravel	Automation tooling and workflow integrations for Laravel projects.
Billing	liberu-billing/billing-laravel	Subscription and billing management integrations (payments, invoices).
Boilerplate (core)	liberusoftware/boilerplate	Core starter and shared utilities used across Liberu projects.
Browser Game	liberu-browser-game/browser-game-laravel	Example Laravel-based browser game platform and mechanics.
CMS	liberu-cms/cms-laravel	Content management features and modular page administration.
Control Panel	liberu-control-panel/control-panel-laravel	Administration/control-panel components for managing services.
CRM	liberu-crm/crm-laravel	Customer relationship management features and integrations.
E‑commerce	liberu-ecommerce/ecommerce-laravel	E‑commerce storefront, product and order management.
Genealogy	liberu-genealogy/genealogy-laravel	Family tree and genealogy features built on Laravel.
Maintenance	liberu-maintenance/maintenance-laravel	Scheduling, tracking and reporting for maintenance tasks.
Real Estate	liberu-real-estate/real-estate-laravel	Property listings and real-estate management features.
Social Network	liberu-social-network/social-network-laravel	Social features, profiles, feeds and messaging for Laravel apps.

Contributing

Contributions are very welcome! Here is how to get involved:

Fork the repository and create your feature branch from main (git checkout -b feature/my-feature).
Write tests for any new behaviour and make sure the existing test suite stays green (./vendor/bin/phpunit).
Follow PSR-12 coding style — run ./vendor/bin/pint to auto-format your code before committing.
Commit your changes with a descriptive message and push to your fork.
Open a Pull Request against main. Describe what you changed, why and how to test it. One of the maintainers will review it as soon as possible.

For bug reports and feature requests, please open an issue.

License

This project is released under the MIT License — one of the most permissive open-source licences available.

What this means for you:

✅ Free to use in personal, commercial and SaaS projects at no cost.
✅ Free to modify — adapt the code to suit your exact requirements.
✅ Free to distribute — share your modified version with others.
✅ No copyleft obligation — you are not required to open-source your own application built on top of this project.
✅ No warranty — the software is provided "as is"; you take responsibility for how you use it.

The only requirement is that the original copyright notice and licence text are included in any copy or substantial portion of the software. See the LICENSE file for the full text.

Made with ♥ by Liberu

automation-laravel / automation-laravel

Maintainers

Package info

Fund package maintenance!

Statistics

Security