How medusajs/b2b-starter-medusa works
This is a Medusa B2B commerce starter: shoppers and company employees browse and purchase, while company admins and merchants manage organizations, approvals, and quotes. The graph follows the storefront-to-backend API shape and includes the backend workflow and domain layers. README capabilities are retained where the tree supports them; storefront request wiring and several feature implementations were not sampled, so those connections are shown at subsystem level rather than as detailed call chains.
Main entry points: store Store API · admin Admin API · modules Storefront Features · (checkout) Cart & Checkout
Components 22
Storefront
- Commerce Pages
storefront/src/app/[countryCode]/(main) - Account Pages
storefront/src/app/[countryCode]/(main)/account - Cart & Checkout
storefront/src/app/[countryCode]/(checkout) - Storefront Features
storefront/src/modules - Storefront Data
storefront/src/lib/data
Merchant Admin
- Management Screens
backend/src/admin/routes - Admin API Hooks
backend/src/admin/hooks/api - Admin Client
backend/src/admin/lib/client.ts
Backend Domain
- Company Workflows
backend/src/workflows/company/workflows - Employee Workflows
backend/src/workflows/employee/workflows - Approval Workflows
backend/src/workflows/approval/workflows - Quote Workflows
backend/src/workflows/quote/workflows - Cart Validation Hooks
backend/src/workflows/hooks - Company Module
backend/src/modules/company - Approval Module
backend/src/modules/approval - Quote Module
backend/src/modules/quote
Other components
- Shopper / Employee
- Merchant
- Medusa Commerce
- Payment & Shipping
Connections 28
- Shopper / Employee → Commerce Pages: browses
- Shopper / Employee → Account Pages: manages account
- Shopper / Employee → Cart & Checkout: purchases
- Merchant → Management Screens: manages commerce
- Commerce Pages → Storefront Features: renders features
- Account Pages → Storefront Features: renders features
- Cart & Checkout → Storefront Features: renders features
- Storefront Features → Storefront Data: loads and mutates
- Storefront Data → Store API: requests
- Management Screens → Admin API Hooks: uses data hooks
- Admin API Hooks → Admin Client: uses client
- Admin Client → Admin API: requests
- Store API → Company Workflows: runs company ops
- Store API → Approval Workflows: runs approval ops
- Store API → Quote Workflows: runs quote ops
- Store API → Cart Validation Hooks: validates carts
- Admin API → Company Workflows: runs company ops
- Admin API → Approval Workflows: runs approval ops
- Admin API → Quote Workflows: runs quote ops
- Company Workflows → Company Module: updates domain
- Employee Workflows → Company Module: updates domain
- Approval Workflows → Approval Module: updates domain
- Quote Workflows → Quote Module: updates domain
- Cart Validation Hooks → Approval Module: checks approval state
- Store API → Medusa Commerce: queries commerce
- Store API → Payment & Shipping: lists shipping
- Cart & Checkout → Payment & Shipping: uses checkout services
- Store API → Medusa Commerce: supports cart and orders