Liberu Ecommerce

---

Build powerful, scalable e-commerce solutions with Laravel 12, 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 12, 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

---

Installation

Requirements

• PHP 8.5+
• Composer
• Node.js 20+
• A database: MySQL, MariaDB or PostgreSQL
• Docker (optional)

Option 1 — Automated script (recommended)

The repository ships with an interactive setup script that guides you through environment configuration, dependency installation, database migration and seeding in one step.

Command line:

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

The script will prompt you to copy .env.example to .env, confirm your database credentials, run composer install, generate the application key, run migrations and seed the database, and optionally start the development server — all interactively.

Graphical installer:

If a graphical installer package is available for your platform, it can be downloaded from the Releases page. Run it and follow the on-screen prompts to configure and install the application without using the terminal.

Option 2 — Manual step-by-step

git clone https://github.com/liberu-ecommerce/ecommerce-laravel.git
cd ecommerce-laravel
composer install
cp .env.example .env
php artisan key:generate

Configure .env — update database credentials and add your payment/dropshipping keys:

DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

STRIPE_KEY=pk_test_xxx
STRIPE_SECRET=sk_test_xxx
STRIPE_WEBHOOK_SECRET=whsec_xxx

DROPXL_API_KEY=Bearer xxx
DROPXL_API_URL=https://api.dropxl.com

Run migrations and seed:

php artisan migrate --seed
npm install && npm run build

Start the development server:

php artisan serve
# or with Docker / Sail:
# ./vendor/bin/sail up -d

Option 3 — Docker

git clone https://github.com/liberu-ecommerce/ecommerce-laravel.git
cd ecommerce-laravel
cp .env.example .env          # update DB_ and app values
docker-compose up -d
docker-compose exec app php artisan migrate --seed

---

Stripe Setup and Testing

1. Add Stripe keys to .env (see above).
2. Use Stripe test cards in checkout:
   • Card number: 4242 4242 4242 4242 — any future expiry, any CVC, any ZIP.
3. For webhooks, install the Stripe CLI, set STRIPE_WEBHOOK_SECRET and forward events to /stripe/webhook.

---

Dropshipping (DropXL)

DropXL integration is configurable via config/dropshipping.php. On checkout, select "Ship directly to recipient (Drop shipping)" to route the order through DropXL. Supplier order placement is queued after a successful payment; orders will include supplier_id and supplier_reference.

For local testing, point DROPXL_API_URL to a mock endpoint returning:

{ "success": true, "data": { "id": "dropxl-123", "reference": "DLX-123" } }

---

Troubleshooting

• Orders stuck at supplier_queued — verify the queue worker is running (php artisan queue:work --tries=3) and check storage/logs/laravel.log.
• Stripe charges fail — validate STRIPE_SECRET in .env, confirm the publishable key is present in config/services.php, and review the logs for API errors.

---

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	liberu-ecommerce/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.

---

Contributing

Contributions are warmly welcomed! Here is how to get involved:

1. Fork the repository and create a feature branch from main.
2. Write focused, testable code — add or update tests for any new behaviour.
3. Run the CI checks locally before pushing:

   ./vendor/bin/phpunit

4. Open a Pull Request against main with a clear description of what you changed and why.
5. The CI pipeline (install, tests, Docker workflows) must pass before a PR can be merged.
6. A maintainer will review your PR, suggest changes if necessary, and merge when ready.

If you have a larger feature in mind, please open an issue first to discuss the approach — this avoids duplicated effort and helps us keep the codebase cohesive.

---

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.

---

Advanced Features (Latest from Shopify & Magento 2)

This platform now includes enterprise-grade features inspired by the latest Shopify and Magento 2 (Adobe Commerce) releases:

Customer Intelligence

• Customer Segmentation - Target customers based on behavior, LTV, and purchase history with rule-based conditions
• Customer Analytics & LTV - Track lifetime value, retention scores, and predictive analytics
• Customer Metrics Dashboard - Comprehensive customer behavior tracking and analysis

AI-Powered Personalization

• Product Recommendations - Collaborative filtering, personalized, trending, and "also bought" suggestions
• Product Interaction Tracking - Track views, cart adds, purchases for better insights
• Recommendation Engine - Multiple recommendation types with scoring algorithms

Product Management

• Product Taxonomy - Hierarchical categorization with custom attributes for better organization
• Product Performance Analytics - Track views, conversions, and return rates per product
• Multi-location Inventory - Advanced inventory management across multiple locations

Marketing & Conversion

• A/B Testing Framework - Built-in testing with variant assignment and conversion tracking
• Abandoned Cart Recovery - Automated campaigns with email/SMS triggers and discount codes
• Conversion Funnel Analytics - Track customer journey and optimize conversion paths

Customer Experience

• Gift Registry - Complete registry system for weddings, baby showers, and other events
• Loyalty & Rewards Program - Points, tiers, and reward redemptions (from WooCommerce features)
• B2B Wholesale Pricing - Tiered pricing, quote requests, and wholesale groups (from WooCommerce features)

Operations

• Product Bundles - Create product kits with special pricing (from WooCommerce features)
• Refund & Return Management - Full RMA system with inventory restocking (from WooCommerce features)
• Multi-currency Support - Currency management with exchange rates (from WooCommerce features)
• Tax Management - Location-based tax calculation (from WooCommerce features)

📚 Detailed Documentation: See SHOPIFY_MAGENTO_FEATURES.md and WOOCOMMERCE_FEATURES.md for complete feature guides.

Console Commands

# Calculate customer segments
php artisan segments:calculate

# Generate product recommendations
php artisan recommendations:generate

# Update customer metrics (LTV, retention, etc.)
php artisan metrics:update-customers

Admin Panel

Filament admin resources are available for managing:

• Customer Segments (/admin/customer-segments)
• Gift Registries
• A/B Tests
• Cart Recovery Campaigns
• And all other features...