Commerce primitives for AdonisJS 7
Commerce that feels native to AdonisJS.
Own your schema and HTTP surface. Keep catalog, carts, inventory, orders, payments, and checkout behind small replaceable ports.
From a blank app to a working commerce contract.
Configurators publish ordinary AdonisJS files. You can inspect, change, test, and commit every route, migration, and policy.
- 1InstallChoose core services, then add only the HTTP and provider packages you need.
- 2PublishGenerate host-owned config, schema, controllers, validators, and routes.
- 3VerifyRun migrations and doctor before the first cart is created.
$ pnpm add @adocommercekit/core \
@adocommercekit/storefront-api
$ node ace configure @adocommercekit/core
$ node ace configure @adocommercekit/storefront-api
$ node ace migration:run
$ node ace commerce:doctor
✓ configuration valid
✓ 12 core migrations present
✓ payment driver healthy
✓ inventory reservations balancedA kit with a hard ownership boundary.
The package owns reusable commerce invariants. Your application owns customer trust, policy, and the final interface.
Read the architectureThe kit publishes portable migrations. The host reviews, commits, runs, and extends them.
The kit supplies a secured baseline. The host owns auth, locale, caching, response shape, and deployment.
Drivers normalize capability and state. The host owns credentials, merchant contracts, webhooks, and customer UX.
Services preserve invariants. The host owns queues, observability, backups, reconciliation, and incident response.
Local rails without regional logic in core.
Add QRIS, virtual accounts, kode unik, Indonesian logistics, exponent-0 IDR, PPN evidence, PDP workflows, and WhatsApp through the same generic ports.
Open the Indonesia guideStart with the contract you need
Follow one focused path, then return to the reference when you need the full surface.
Current workspace version: 1.3.0-0
Prerelease packages remain beta or experimental. Pin matching exact versions and review every generated-file and migration change.