How medusajs/b2b-starter works
Medusa B2B Starter combines a Next.js commerce storefront with a Medusa backend. A customer browses products, manages a cart, and checks out; business accounts add company employees, spending controls, order approvals, and quote negotiation. Merchants administer companies, approvals, and quotes through the Medusa admin. The backend exposes store/admin APIs and uses workflows and domain modules for B2B operations. README capabilities also include bulk cart updates, promotions, free-shipping progress, and order editing. Several storefront and API relationships are inferred from product documentation; only evidenced call paths are solid.
Main entry points: page.tsx Merchant dashboard · route.ts Commerce endpoints · workflows Company workflows · index.tsx Cart
Components 25
Customer storefront
- Product catalog
apps/storefront/src/app/[countryCode]/(main)/products/[handle]/page.tsx - Cart
apps/storefront/src/modules/cart/templates/index.tsx - Checkout
apps/storefront/src/app/[countryCode]/(checkout)/checkout/page.tsx - Business account
apps/storefront/src/app/[countryCode]/(main)/account/@dashboard/company/page.tsx - Quote portal
apps/storefront/src/app/[countryCode]/(main)/account/@dashboard/quotes/page.tsx - Storefront data access
apps/storefront/src/lib/data
Backend APIs
- Company endpoints
apps/backend/src/api/store/companies/route.ts - Approval endpoints
apps/backend/src/api/store/approvals/route.ts - Quote endpoints
apps/backend/src/api/store/quotes/route.ts - Commerce endpoints
apps/backend/src/api/store/free-shipping/prices/route.ts - Admin company API
apps/backend/src/api/admin/companies/route.ts - Admin approval API
apps/backend/src/api/admin/approvals/route.ts - Admin quote API
apps/backend/src/api/admin/quotes/route.ts
B2B domain
- Company workflows
apps/backend/src/workflows/company/workflows - Employee workflows
apps/backend/src/workflows/employee/workflows - Approval workflows
apps/backend/src/workflows/approval/workflows - Quote workflows
apps/backend/src/workflows/quote/workflows - Company domain
apps/backend/src/modules/company/service.ts - Approval domain
apps/backend/src/modules/approval/service.ts - Quote domain
apps/backend/src/modules/quote/service.ts
Commerce operations
- Order and cart operations
apps/backend/src/workflows - Commerce data store
Merchant admin
- Merchant dashboard
apps/backend/src/admin/routes/companies/page.tsx
Other components
- Business customer
- Merchant
Connections 26
- Business customer → Product catalog: browses
- Business customer → Cart: shops with
- Cart → Checkout: proceeds to
- Business customer → Business account: manages account
- Business customer → Quote portal: negotiates quotes
- Merchant → Merchant dashboard: administers
- Business account → Company endpoints: uses
- Quote portal → Quote endpoints: uses
- Cart → Commerce endpoints: requests shipping prices
- Company endpoints → Company workflows: creates companies
apps/backend/src/api/store/companies/route.ts - Company workflows → Approval workflows: creates default settings
apps/backend/src/workflows/company/workflows/create-companies.ts - Company workflows → Company domain: links company records
apps/backend/src/workflows/company/workflows/create-companies.ts - Company endpoints → Company domain: queries company data
- Approval endpoints → Commerce data store: queries approval data
apps/backend/src/api/store/approvals/route.ts - Quote endpoints → Quote workflows: creates quote request
apps/backend/src/api/store/quotes/route.ts - Quote workflows → Quote domain: manages quote records
- Admin company API → Company workflows: creates companies
apps/backend/src/api/admin/companies/route.ts - Admin approval API → Commerce data store: queries approval data
apps/backend/src/api/admin/approvals/route.ts - Merchant dashboard → Admin company API: administers companies
- Merchant dashboard → Admin approval API: manages approvals
- Merchant dashboard → Admin quote API: manages quotes
- Commerce endpoints → Commerce data store: reads cart
apps/backend/src/api/store/free-shipping/prices/route.ts - Commerce endpoints → Order and cart operations: lists shipping options
apps/backend/src/api/store/free-shipping/prices/route.ts - Employee workflows → Company domain: manages employee relations
- Approval workflows → Approval domain: manages approval records
- Storefront data access → Commerce endpoints: requests commerce data