# Aimeos

Laravel e-commerce package configured through config/shop.php, with JSON:API and GraphQL admin API.

Full-featured Laravel commerce distribution: catalog, basket, checkout, subscriptions, multi-vendor, multi-channel, and an admin backend, with 100+ payment gateways. The frontend is a JSON:API and the admin is a GraphQL API, both shipped by the Builder. MIT licensed; the Builder documents configuration in depth.

Alternative to: Shopify, Adobe Commerce

- Capabilities: adaptable, operable
- Vertical: ecommerce
- Shape: business-app
- Form factor: web-app
- Execution model: deterministic
- Provenance: human-written (recorded, never ranked)
- Repo: https://github.com/aimeos/aimeos (MIT), 5449 stars, last commit 2026-07-29
- Last activity: 2026-07-29
- Page: apps/aimeos--aimeos.html
- JSON: apps/aimeos--aimeos.json

## Use it when

- I want a Laravel shop with subscriptions or multi-vendor that I can tune in one config file
- I need a JSON:API storefront backend and a GraphQL admin API so agents and apps can both drive it

## Gotchas

- Authentication for the APIs is not spelled out on the JSON:API getting-started page
- The aimeos/aimeos repo is the Laravel distribution; the core lives in aimeos/aimeos-core and other packages

## Editions

- Open source: Free, open source
  - source: composer create-project aimeos/aimeos myshop
  - container: docker compose up

## Adaptable: make it yours

Effort: config-only (20 things to edit)

The .env sets the Laravel basics plus SHOP_MULTISHOP, SHOP_MULTILOCALE, SHOP_REGISTRATION, and SHOP_PERMISSION; config/shop.php is the large documented switchboard for catalog, basket, checkout, payment, and delivery behavior. Aimeos's docs cover configuration exhaustively, so a standard shop is a config job; template overrides are the first code step.

- Env vars: APP_NAME, APP_URL, APP_KEY, DB_CONNECTION, DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD, MAIL_MAILER, MAIL_HOST, MAIL_FROM_ADDRESS, CACHE_DRIVER, QUEUE_CONNECTION, SHOP_MULTISHOP, SHOP_MULTILOCALE, SHOP_REGISTRATION, SHOP_PERMISSION, AWS_BUCKET
- Config files: .env, config/shop.php
- Prompt files: none
- Accounts you'll need: payment gateway account (Omnipay providers)

## Operable: what an agent can drive

Operability: official. Interface: api at https://aimeos.org/docs/latest/frontend/jsonapi/ (published by the builder, local).

### Reach (partial coverage)

- Browse catalog, products, attributes: reachable. JSON:API docs: products, attributes, catalog resources
- Basket and checkout: reachable. JSON:API docs: basket, services (payment/delivery), orders
- Customer accounts and addresses: reachable. JSON:API docs: customer resources
- Reviews and subscriptions: reachable. JSON:API docs: reviews, subscriptions
- Admin: manage products and stock: reachable. docs list GraphQL admin API and JsonAdm for products, orders, customers, coupons, settings
- Admin: manage orders: reachable. GraphQL admin API per docs
- Admin: coupons and system settings: reachable. GraphQL admin API per docs
- Multi-vendor marketplace features: undetermined. README says marketplace is an extension; API coverage of vendor accounts unverified

## Code stack

- Languages: PHP, JavaScript
- Frameworks: Laravel, Vue.js
- Package manager: composer
- Database: MySQL, PostgreSQL, SQL Server
- Hosting target: Docker, Kubernetes, AWS/GCP/Azure, any PHP host

## Evidence and confidence

- formFactor: README: Laravel ecommerce platform with admin backend (confidence 0.95)
- executionModel: no model at runtime (AI translation is an optional feature) (confidence 0.9)
- operability: aimeos.org docs publish the JSON:API frontend and GraphQL admin API (confidence 0.9)
- effort: .env.example names SHOP_* vars; README: 'extremely configurable' (confidence 0.75)
- editions: MIT; no paid edition found on the docs page (confidence 0.6)
- active: pushedAt 2026-07-29
- reach:  (confidence 0.8)

## Open questions

- Does Aimeos sell paid extensions or hosting (aimeos.org mentions partner support)
- API auth method for JSON:API and GraphQL admin

## Sources

- https://github.com/aimeos/aimeos (sourcing:ecommerce:curated)
- https://aimeos.org/docs/latest/frontend/jsonapi/ (sourcing:ecommerce:curated)