README

A curated checkout-and-fulfillment bundle for Laravel commerce applications.

Overview

AIArmada Commerce is a modular e-commerce toolkit for Laravel applications. The metapackage installs the checkout-and-fulfillment foundation plus authorization; install other domains separately when they are part of the application.

Requirements

Requirement	Version
PHP	8.4+
Laravel	13.0+
Filament	5.0+

Installation

Install the curated commerce bundle:

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
authz	Authorization contracts and role/permission support

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

Installed separately

The bundle intentionally excludes signals and growth (analytics), membership (entitlements), moderation (content blocks), and references (bibliographic data). Install those packages separately when your application needs those domains.

Quick Start

1. Install the Bundle

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;
use AIArmada\FilamentAuthz\FilamentAuthzPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            CommerceNavigationPlugin::make(),
            FilamentCartPlugin::make(),
            FilamentVouchersPlugin::make(),
            FilamentDocsPlugin::make(),
            FilamentAuthzPlugin::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

Package info

Security

Statistics