README

A powerful collection of commerce components for Laravel - build and ship e-commerce features fast.

Overview

AIArmada Commerce is a modular e-commerce toolkit for Laravel applications. Install the complete suite or pick individual packages based on your needs.

Requirements

Requirement	Version
PHP	8.4+
Laravel	13.0+
Filament	5.0+

Installation

Install the complete commerce suite:

composer require aiarmada/commerce

Or install individual packages as needed (see below).

Included Packages

Core Packages

Package	Description
commerce-support	Core utilities, contracts, and exceptions
cart	Shopping cart with conditions and database-backed persistence
inventory	Inventory and stock management
vouchers	Discount codes and promotional vouchers
docs	Invoice and receipt generation with PDF

Payment & Shipping

Package	Description
chip	CHIP payment gateway integration
cashier	Payment orchestration layer
cashier-chip	CHIP adapter for Cashier
jnt	J&T Express shipping integration

Filament Admin

Package	Description
filament-cart	Cart management admin panel
filament-inventory	Inventory management admin panel
filament-vouchers	Voucher management admin panel
filament-docs	Document management admin panel
filament-chip	CHIP payment admin panel
filament-jnt	J&T Express admin panel
filament-authz	Role & permission management

Quick Start

1. Install the Suite

composer require aiarmada/commerce

2. Publish Configurations

php artisan vendor:publish --tag=cart-config
php artisan vendor:publish --tag=vouchers-config
php artisan vendor:publish --tag=chip-config
# ... etc

3. Run Migrations

php artisan migrate

4. Register Filament Plugins

use AIArmada\CommerceSupport\Support\Filament\CommerceNavigationPlugin;
use AIArmada\FilamentCart\FilamentCartPlugin;
use AIArmada\FilamentVouchers\FilamentVouchersPlugin;
use AIArmada\FilamentDocs\FilamentDocsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            CommerceNavigationPlugin::make(),
            FilamentCartPlugin::make(),
            FilamentVouchersPlugin::make(),
            FilamentDocsPlugin::make(),
            // ... other plugins
        ]);
}

5. Configure Payment Gateway

php artisan commerce:setup

Documentation

See the docs folder for detailed documentation:

Installation - Complete setup guide
Usage - Package overview and selection
Configuration - Environment and config options
Troubleshooting - Common bundle-install issues

Individual Package Installation

Install only what you need:

# Cart functionality
composer require aiarmada/cart aiarmada/filament-cart

# Vouchers/discounts
composer require aiarmada/vouchers aiarmada/filament-vouchers

# Payment processing
composer require aiarmada/chip aiarmada/cashier aiarmada/cashier-chip

# Document generation
composer require aiarmada/docs aiarmada/filament-docs

# Shipping
composer require aiarmada/jnt aiarmada/filament-jnt

License

The MIT License (MIT). See LICENSE for details.

aiarmada / commerce

Maintainers

Package info

Statistics

Security