liberusoftware / ecommerce-laravel
Liberu Ecommerce — an open-source e-commerce platform built on Laravel, Filament and Livewire.
Maintainers
Package info
github.com/liberusoftware/ecommerce-laravel
Type:project
pkg:composer/liberusoftware/ecommerce-laravel
Fund package maintenance!
Requires
- php: ^8.5
- bezhansalleh/filament-shield: ^4.0
- biostate/filament-menu-builder: ^5.0
- bursteri/socialstream: ^7.0
- filament/filament: ^5.0
- filament/spatie-laravel-settings-plugin: ^5.0
- guzzlehttp/guzzle: ^7.8
- laravel/cashier: ^16.6
- laravel/framework: ^13
- laravel/horizon: ^5.47
- laravel/jetstream: ^5.1
- laravel/octane: ^2.3
- laravel/reverb: ^1.10
- laravel/sanctum: ^4.0
- laravel/tinker: ^3.0
- livewire/livewire: ^4.0
- orangehill/iseed: ^3.0
- spatie/laravel-menu: ^4.2
- spatie/laravel-permission: ^6.0
- spatie/laravel-query-builder: ^7.0
- srmklive/paypal: ^3.1
- webonyx/graphql-php: ^15.34
Requires (Dev)
- driftingly/rector-laravel: ^2.5
- fakerphp/faker: ^1.23
- laravel/pail: ^1.2.2
- laravel/pint: ^1.13
- laravel/sail: ^1.41
- mockery/mockery: ^1.6
- nunomaduro/collision: ^8.6
- phpunit/phpunit: ^13.0
- rector/rector: ^2.5
- spatie/laravel-ignition: ^2.4
This package is auto-updated.
Last update: 2026-08-12 21:03:46 UTC
README
Build powerful, scalable e-commerce solutions with Laravel 13, PHP 8.5, Filament 5 and Livewire 4 — open-source and ready for production.
About Liberu Ecommerce
Liberu Ecommerce is a modular, production-ready e-commerce platform built on the latest versions of Laravel 13, PHP 8.5, Filament 5 and Livewire 4. It is part of the Liberu open-source ecosystem — a suite of Laravel-based applications designed to give developers a solid, extensible foundation for real-world business software.
Whether you are launching a small online shop or building a multi-vendor marketplace, Liberu Ecommerce provides the tools, architecture and integrations to get there quickly and confidently. The codebase follows Laravel best practices, uses a clean Filament admin panel, and ships with reactive Livewire components so you spend less time on boilerplate and more time on your product.
Main Features
Storefront & Cart
- Reactive shopping cart and checkout built with Livewire 4
- Multiple shipping methods with server-side rate calculation and drop-shipping support
- Guest and authenticated checkout flows
Payments
- Payment gateway factory with pluggable implementations
- Built-in Stripe integration (charges, webhooks, test mode)
- PayPal integration ready to activate
Dropshipping
- First-class DropXL supplier integration via
config/dropshipping.php - Supplier order placement queued after successful payment
- Extensible supplier transformation layer for additional providers
Product & Order Management
- Full product catalogue with categories, attributes and images
- Order persistence, status tracking and order-item management
- Customer Segmentation — target customers based on behaviour, LTV and purchase history
- AI-Powered Product Recommendations — collaborative filtering, personalised suggestions and trending items
- A/B Testing Framework — built-in variant assignment and conversion tracking
- Abandoned Cart Recovery — automated campaigns with email/SMS triggers and discount codes
- Gift Registry — complete registry system for weddings, baby showers and other events
- Loyalty & Rewards Programme — points, tiers and reward redemptions
- B2B Wholesale Pricing — tiered pricing, quote requests and wholesale groups
- Multi-currency & Tax Management — exchange rates and location-based tax calculation
- Refund & Return Management — full RMA system with inventory restocking
Admin Panel
Powered by Filament 5, the admin panel provides resources for managing:
- Products, categories, orders and customers
- Customer Segments, Gift Registries, A/B Tests and Cart Recovery Campaigns
- Shipping methods, payment gateways and supplier configuration
Operations & Analytics
- Customer analytics and LTV tracking
- Product performance analytics (views, conversions, return rates)
- Multi-location inventory management
- Conversion funnel analytics
Requirements and quick start
PHP 8.5+ · Composer · Node.js 20+ · MySQL, MariaDB or PostgreSQL · Docker (optional)
git clone https://github.com/liberusoftware/ecommerce-laravel.git
cd ecommerce-laravel
chmod +x setup.sh
./setup.sh
setup.sh is interactive: it copies .env.example, confirms database credentials, installs dependencies, generates the key, migrates and seeds. Manual and Docker installs, Stripe configuration and the DropXL setup are in docs/INSTALLATION.md.
Documentation
| Document | Covers |
|---|---|
docs/index.md |
Index of everything in docs/ — what each document is, and whether it is current |
docs/INSTALLATION.md |
Manual and Docker installs, Stripe, DropXL |
docs/OPERATIONS.md |
Console commands, the admin panels, queues, troubleshooting |
docs/MODULE_DEVELOPMENT.md |
Building, testing, promoting and releasing a module |
docs/CONFORMANCE.md |
Where this repository stands against the Liberu standards |
docs/MIGRATION_PLAN.md |
The ordered plan from here to the modular target |
docs/adr/ |
Architecture decision records |
CONTRIBUTING.md |
The quality gates, the five workflows, and the ADR rule |
SECURITY.md |
Reporting a vulnerability privately, and what is in scope |
CONTEXT.md |
Domain glossary — merchant, team, store, channel, tenant |
Our Projects
Liberu Ecommerce is part of the wider Liberu open-source ecosystem. All projects are built on the same modern Laravel stack and are designed to work together.
| 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 (payments, invoices). |
| Boilerplate (core) | liberusoftware/boilerplate | Core starter and shared utilities used across Liberu projects. |
| Browser Game | liberu-browser-game/browser-game-laravel | 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 | liberusoftware/ecommerce-laravel | E-commerce storefront, product and order management (this repo). |
| 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. |
Security
Please do not report security vulnerabilities through public GitHub issues. Follow SECURITY.md for private reporting through GitHub Security Advisories, and for what is in and out of scope.
Contributing
Contributions are warmly welcomed. Branch from main, keep the change to one outcome, and run the gates before pushing:
composer check # Pint, PHPStan, then the test suite
CONTRIBUTING.md has the rest: what each gate checks and why it is scoped the way it is, the five CI workflows, when a change needs an ADR, and the two documents in docs/ with opposite editing rules. Read it before a first pull request — several of the rules here are not the obvious ones, and the reasoning is recorded rather than assumed.
For a larger feature, open an issue first. This repository is mid-migration and the work is sequenced, so a change that lands out of order costs more to reconcile than it saves.
License
This project is licensed under the MIT Licence — see the LICENSE file for the full text.
What this means for you
The MIT licence is one of the most permissive open-source licences available. In practical terms:
- ✅ Use freely — use the software in any project, commercial or personal, at no cost.
- ✅ Modify — change the source code to suit your needs without restriction.
- ✅ Distribute — share the original or your modified version with anyone.
- ✅ Sublicence — incorporate the code into proprietary software and distribute under your own terms.
- ℹ️ Attribution required — keep the original copyright notice and licence text in any copy or substantial portion of the software.
- ℹ️ No warranty — the software is provided "as is"; the authors accept no liability for damages arising from its use.
Choosing MIT means you can adopt Liberu Ecommerce as the foundation for a commercial product without legal concerns, while still benefiting from community improvements and contributions.