https://github.com/medusajs/b2b-starter-medusa
Official Medusa B2B Starter template. Features common B2B ecommerce requirements and can be easily adapted and extended.
https://github.com/medusajs/b2b-starter-medusa
b2b b2b-ecommerce ecommerce medusa medusajs nextjs nextjs-starter nextjs-template open-source opensource oss starter starter-kit starter-template template
Last synced: 8 months ago
JSON representation
Official Medusa B2B Starter template. Features common B2B ecommerce requirements and can be easily adapted and extended.
- Host: GitHub
- URL: https://github.com/medusajs/b2b-starter-medusa
- Owner: medusajs
- License: mit
- Created: 2024-09-17T09:06:02.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-28T09:26:08.000Z (8 months ago)
- Last Synced: 2025-04-28T10:39:37.717Z (8 months ago)
- Topics: b2b, b2b-ecommerce, ecommerce, medusa, medusajs, nextjs, nextjs-starter, nextjs-template, open-source, opensource, oss, starter, starter-kit, starter-template, template
- Language: TypeScript
- Homepage: https://dub.sh/medusa-b2b-starter
- Size: 27.4 MB
- Stars: 237
- Watchers: 18
- Forks: 113
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Medusa B2B Commerce Starter
Customizable B2B ecommerce built with Medusa 2.0 & Next.js Storefront
## Table
- [Prerequisites](#prerequisites)
- [Overview](#overview)
- [Features](#features)
- [Demo](#demo)
- [Quickstart](#quickstart)
- [Update](#update)
- [Resources](#resources)
- [Contributors](#contributors)
## Prerequisites
⚠️ We have tested this repo with the below versions:
- ✅ Node 20
- ✅ Postgres 15
- ✅ Medusa 2.4
- ✅ Next.js 15
## Overview
For a full feature overview, please visit [the project wiki](https://github.com/medusajs/b2b-starter-medusa/wiki).
#### Core 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
```bash
# 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](http://localhost:9000/app/settings/publishable-api-keys)
- 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](http://localhost:9000/app)
- [Medusa Storefront](http://localhost:8000)
# 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](https://www.medusajs.com/)
- [GitHub](https://github.com/medusajs)
- [2.0 Documentation](https://docs.medusajs.com/v2)
#### Learn more about Next.js
- [Website](https://nextjs.org/)
- [GitHub](https://github.com/vercel/next.js)
- [Documentation](https://nextjs.org/docs)
## Contributors
