How shopnex-ai/shopnex works
ShopNex is a Payload CMS-based commerce platform with a storefront, administrative commerce data, and optional extensions. Its principal customer journey is browsing products, managing a cart, completing checkout/payment, and receiving an order confirmation. The tree also includes alternative storefronts, an email-template editor, and plugins. Several connections below reflect README-documented capabilities; sampled source was limited, so internal wiring beyond explicit API/config and auth behavior is not inferred.
Main entry points: route.ts Payload API · checkout Checkout Steps · (storefront) Simple Storefront · Orders.ts Order Processing
Components 25
Storefronts
- Shop Routes
apps/shop/src/app/(main) - Catalog Views
apps/shop/src/templates - Cart Page
apps/shop/src/app/(main)/cart/page.tsx - Checkout Steps
apps/shop/src/app/(checkout)/checkout - Account Pages
apps/shop/src/app/(main)/account - Builder Storefront
apps/builder-shop/src/app - Simple Storefront
apps/simple-shop/src/app/(storefront)
Commerce Core
- Cart and Orders
apps/simple-shop/src/collections/Carts - Products
apps/simple-shop/src/collections/Products/Products.ts - Order Processing
apps/simple-shop/src/collections/Orders/Orders.ts - Payment Records
apps/simple-shop/src/collections/Payments.ts - Shipping Setup
apps/simple-shop/src/collections/Shipping.ts - Payload API
apps/simple-shop/src/app/(payload)/api/[...slug]/route.ts - Payload Config
apps/simple-shop/src/payload.config.ts - CMS Admin
apps/simple-shop/src/app/(payload)/admin
Content Tools
- Puck Page Editor
apps/simple-shop/src/collections/Pages - Builder.io Plugin
packages/builder-io-plugin/src
Extensions
- App Authentication
packages/auth-plugin/src/plugins/app.ts - Analytics Dashboard
packages/analytics-plugin/src - CJ Integration
packages/cj-plugin/src/error-handler.ts
Email Editor
- Email Template Editor
apps/shopnex-email/clients/hooks/useEmailEditor.ts - Payload SDK
apps/shopnex-email/clients/utils/sdk.ts
Other components
- Shopper
- Stripe
- Shipping Providers
Connections 19
- Shopper → Shop Routes: browses
- Shop Routes → Catalog Views: renders
- Shopper → Cart Page: manages cart
- Cart Page → Checkout Steps: starts checkout
- Checkout Steps → Order Processing: creates order
- Checkout Steps → Payment Records: processes payment
- Order Processing → Stripe: charges through
- Order Processing → Shipping Providers: ships through
- Shopper → Simple Storefront: shops
- Simple Storefront → Products: browses
- Simple Storefront → Cart and Orders: uses cart
- Payload API → Payload Config: loads config
- CMS Admin → Payload API: manages data
- Puck Page Editor → Payload API: stores pages
- Builder Storefront → Builder.io Plugin: uses content
- Shopper → Account Pages: manages account
- Account Pages → App Authentication: authenticates with
- Email Template Editor → Payload SDK: loads and saves
- Payload SDK → Payload API: requests templates