Medusa B2B Commerce Starter, stored in the b2b-starter-medusa repository, is an official open-source template from the Medusa team that combines a Medusa 2.0 backend with a Next.js 15 storefront for building customizable B2B ecommerce sites. As of the repository's current state, the starter is deprecated and the maintainers direct users to the b2b-starter repository instead, but this page documents the original starter's full feature set and setup flow.
What is Medusa B2B Commerce Starter?
Medusa B2B Commerce Starter is a full-stack starting point for business-to-business ecommerce, pairing a Medusa 2.0 commerce backend with a Next.js 15 storefront built on the App Router. It takes a cloned repository as input and produces a running storefront at localhost:8000 and a Medusa admin at localhost:9000 after following the Quickstart steps. The starter is published by Medusa (medusajs) and carries an open-source license with a PRs-welcome badge. It supports Node 20, Postgres 15, Medusa 2.4, and Next.js 15 as tested versions.
Key Features
- Company Management — Customers can manage their company and invite employees through the storefront's account area.
- Spending Limits — Company admins can assign per-employee spending limits that constrain cart totals.
- Bulk add-to-cart — Customers can add multiple product variants to their cart in a single action.
- Quote Management — Customers and merchants can communicate, accept, or reject quotes through the integrated quote flow.
- Order Edit — Merchants can edit orders or quotes, including adding/removing items and updating quantity and price.
- Company Approvals — Companies can require admin approval before employees finalize a cart.
- Merchant Approvals — Merchants can set up order approval processes to enforce business rules before fulfillment.
- Promotions & Free Shipping Nudge — Customers can apply manual and automatic promotions, and a UI component shows progress toward free shipping.
- Full ecommerce support — Product pages, collections and categories, cart and checkout, user accounts, and order details are included.
- Full Next.js 15 support — The storefront uses App Router, caching, server components/actions, streaming, and static pre-rendering.
Who is it for?
- B2B merchants — Companies that sell to other businesses and need employee hierarchies, spending controls, and quote workflows out of the box.
- Medusa developers — Teams building on Medusa 2.0 who want a pre-built storefront and backend rather than starting from a blank project.
- Ecommerce agencies — Agencies that customize B2B storefronts can use the starter as a base and extend its modules for client projects.
What can you do with Medusa B2B Commerce Starter?
- Company admins: Invite employees, assign spending limits, and approve or reject employee carts before checkout.
- Merchants: Edit order/quotes items and prices, and configure approval processes to keep fulfillment compliant.
- B2B customers: Browse product collections and categories, bulk-add variants to the cart, apply promotions, and track order details in their account.
How does Medusa B2B Commerce Starter work?
The Quickstart walks through two setup folders: backend and storefront. In the backend, you copy the .env.template, run yarn install, create and migrate the database with yarn medusa db:create and yarn medusa db:migrate, seed data, and create an admin user. In the storefront, you copy the .env.template, install dependencies, and add a publishable API key from the Medusa admin to the NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY variable before running yarn dev on both.
FAQ
Is Medusa B2B Commerce Starter free?
Yes, the repository is open-source and the README explicitly welcomes pull requests. There is no mention of a paid license or subscription on the page.
Is this starter still maintained?
The repository currently displays a deprecation warning and directs users to the b2b-starter repository instead. The original feature set remains documented here, but new development is happening in the replacement starter.
What versions does the starter support?
The tested environment is Node 20, Postgres 15, Medusa 2.4, and Next.js 15. The README recommends using yarn install in both projects to update packages to the latest versions.
How do I update the starter?
Run yarn install in both the backend and storefront folders, then run npx medusa db:migrate in the backend. If you are updating from a version without the Approval module, also run npx medusa exec src/scripts/create-approval-settings.ts to add approval settings to existing companies.
