README.md

Medusa B2B Commerce Starter

Customizable B2B ecommerce built with Medusa 2.0 & Next.js Storefront

b2b-video.mp4

Table

• Prerequisites
• Overview
  • Features
  • Demo
• Quickstart
• Update
• Resources
• Contributors

 

Prerequisites

⚠️ We have tested this repo with the below versions:

• ✅ Node 20
• ✅ Postgres 15
• ✅ Medusa 2.4
• ✅ Next.js 15

 

Overview

Features

• Company Management. Customers can manage their company and invite employees.
• Spending Limits. Company admins can assign spending limits to its employees.
• Bulk add-to-cart. Customers can add multiple variants of a product to their cart at once.
• Quote Management. Customers & Merchants can communicate, accept or reject quotes.
• Order Edit. Merchants can edit orders or quotes - add/remove item, update quantity & price management and more.
• Company Approvals. Companies can mandate approvals from company admins before employees can finalize a cart.
• Merchant Approvals. Merchants can set up approval processes for orders, ensuring compliance with business rules before fulfillment.
• Promotions. Customers can apply manual and automatic promotions to their cart.
• Free Shipping Nudge. Displays a component showing progress toward free shipping.
• Full ecommerce support
  • Product Pages
  • Product Collections & Categories
  • Cart & Checkout
  • User Accounts
  • Order Details
• Full Next.js 15 support
  • App Router
  • Caching
  • Server components/actions
  • Streaming
  • Static Pre-Rendering

 

Demo

Quote Management

 

Company Management

 

Approval Management

 

Product Page

 

Cart Summary

 

 

Quickstart

Setup Medusa project

# Clone the repository
git clone https://github.com/medusajs/b2b-starter-medusa.git

## Setup Backend

# Go to the folder
cd ./backend

# Clone .env.template
cp .env.template .env

# Install dependencies
yarn install

# Install dependencies, setup database & seed data
yarn install && yarn medusa db:create && yarn medusa db:migrate && yarn run seed && yarn medusa user -e admin@test.com -p supersecret -i admin

# Start Medusa project - backend & admin
yarn dev

## Setup Storefront

# Go to folder
cd ../storefront

# Clone .env.template
cp .env.template .env

# Install dependencies
yarn install

Setup publishable key

• ✅ Visit Admin: Publishable Key
  • Credentials:
    • email: admin@test.com
    • password: supersecret
• ✅ Copy token key of "Webshop"
• ✅ Open file - storefront/.env
• ✅ Add token to this var - NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY

# Start Medusa storefront
yarn dev

Visit the following links to see the Medusa storefront & admin

• Medusa Admin
• Medusa Storefront

 

Update

Some general guidelines for when you're updating this Starter to a newer version.

Update packages

Run yarn install in both projects to update you're packages to the latest versions.

Run migrations

To reflect any changes made to data models, make sure to run npx medusa db:migrate in the backend project.

Note: are you updating from a version of this Starter that didn't have the Approval module yet? Run npx medusa exec src/scripts/create-approval-settings.ts in the backend project to add approval settings to all existing companies.

Resources

Learn more about Medusa

• Website
• GitHub
• 2.0 Documentation

Learn more about Next.js

• Website
• GitHub
• Documentation

 

Contributors