On this site

Brand Kit API

Storefront checkout, customer accounts, and brand admin routes on your provisioned Spoke server.

Brand Kit API

Runs on your brand server after an approved brand uses nerionx init and nerionx up. The legacy nerionx provision command is for platform development from a monorepo checkout. Storefront routes are public (CORS-scoped to your storefront origin); admin routes require a Brand Kit session with RBAC roles. Checkout is the critical path — it validates the cart locally then forwards to Hub POST /orders with your brand API key server-side.

Commerce & admin

Method	Path	Auth	Description
GET	/storefront/products	None	Local catalog mirror
POST	/storefront/checkout	None (guest, email in body)	Checkout → Hub POST /orders
GET	/admin/orders	Session + RBAC	Brand admin order list
GET	/admin/spoke/me	Session + RBAC	Current admin role

Code examples

Storefront checkout

Brand Kit checkout forwards to Hub POST /orders after local cart validation.

curl -s -X POST "http://localhost:9001/storefront/checkout" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <customer_token>" \
  -d '{
  "items": [{ "sku_id": "SKU-001", "quantity": 1 }],
  "shipping_address": {
    "line1": "1 Main St", "city": "Zurich",
    "postal_code": "8001", "country": "CH"
  }
}'

Environment variables

HUB_API_URL — Hub base (https://api.staging.nerionx.dev)
HUB_API_KEY — Brand live or sandbox key
NEXT_PUBLIC_SPOKE_BACKEND_URL — Storefront proxy target

On this site

Brand Kit API

Storefront checkout, customer accounts, and brand admin routes on your provisioned Spoke server.

Brand Kit API

Commerce & admin

Method	Path	Auth	Description
GET	/storefront/products	None	Local catalog mirror
POST	/storefront/checkout	None (guest, email in body)	Checkout → Hub POST /orders
GET	/admin/orders	Session + RBAC	Brand admin order list
GET	/admin/spoke/me	Session + RBAC	Current admin role

Code examples

Storefront checkout

Brand Kit checkout forwards to Hub POST /orders after local cart validation.

curl -s -X POST "http://localhost:9001/storefront/checkout" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <customer_token>" \
  -d '{
  "items": [{ "sku_id": "SKU-001", "quantity": 1 }],
  "shipping_address": {
    "line1": "1 Main St", "city": "Zurich",
    "postal_code": "8001", "country": "CH"
  }
}'

Environment variables

HUB_API_URL — Hub base (https://api.staging.nerionx.dev)
HUB_API_KEY — Brand live or sandbox key
NEXT_PUBLIC_SPOKE_BACKEND_URL — Storefront proxy target