Development
Build on explicit contracts.
Understand the boundaries, then choose the right place for your integration. Current routes and source examples are linked throughout the guides.
Architecture
Architecture
Follow the boundaries between Core, optional capabilities, provider adapters, and presentation.
Storefront API
API overview
The current v1 endpoint map, catalog and account schemas, request examples, and error conventions.
Authentication and token abilities
Create scoped Sanctum tokens and understand customer ownership, session authentication, and IP restrictions.
Commerce API resources
Read customer-owned orders, invoices, credit notes, support tickets, and optional Module resources.
Cart and checkout API
Cart identity, validated checkout input, payment initiation, and idempotency without client-side totals.
Events and webhooks
Separate in-process domain events, signed outbound deliveries, and incoming payment-provider callbacks.
Package contracts
Building Modules
Module manifests, discovery, registration contracts, dependencies, migrations, and lifecycle behavior.
Building Extensions
Provider-neutral Extension manifests, registration, settings, lifecycle, and adapter contracts.
Theme contracts and assets
Build storefront and Admin presentation with Theme manifests, Blade views, settings, and Vite assets.
Contribute to Agovena
Contribute to Agovena
Find a useful contribution, set up the project, test your change, and open a focused pull request.