https://github.com/mercurjs/mercur
Open-source multi-vendor marketplace platform for B2B & B2C. Built on top of MedusaJS. Create your own custom marketplace. ๐๏ธ
https://github.com/mercurjs/mercur
commerce e-commerce javascript marketplace marketplace-solution medusa medusajs medusajs-v2 multi-vendor multi-vendor-ecommerce multivendor-ecommerce nodejs open-source shopping-cart
Last synced: 23 days ago
JSON representation
Open-source multi-vendor marketplace platform for B2B & B2C. Built on top of MedusaJS. Create your own custom marketplace. ๐๏ธ
- Host: GitHub
- URL: https://github.com/mercurjs/mercur
- Owner: mercurjs
- License: mit
- Created: 2024-04-23T15:36:13.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-12T17:43:43.000Z (about 1 month ago)
- Last Synced: 2026-01-12T20:14:16.669Z (about 1 month ago)
- Topics: commerce, e-commerce, javascript, marketplace, marketplace-solution, medusa, medusajs, medusajs-v2, multi-vendor, multi-vendor-ecommerce, multivendor-ecommerce, nodejs, open-source, shopping-cart
- Language: TypeScript
- Homepage: https://www.mercurjs.com
- Size: 7.14 MB
- Stars: 1,325
- Watchers: 28
- Forks: 283
- Open Issues: 45
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README

# What is Mercur?
Mercur is the first
truly limitless open source marketplace platform that
combines the simplicity of SaaS with the freedom of open
source. Built on
[MedusaJS](https://github.com/medusajs/medusa), it empowers
businesses to create custom marketplaces without choosing
between ownership and ease of use.
Mercur is a platform to start, customize, manage, and scale
your marketplace for every business model with a modern
technology stack.
## Announcing Mercur 1.0
After months of development, testing, and close
collaboration with early adopters, weโre excited to announce
the official release of **Mercur 1.0** - the first truly
limitless marketplace platform. Version 1.0 is fully open
source and ready to be self-hosted, giving you **full
control over infrastructure, customizations, and data**.
With this version, **Mercur is production-ready for B2C
marketplaces**. The first complete version includes a vendor
system, admin panel, and a fully built B2C Storefront. Read
more in
**[official release announcement](https://www.mercurjs.com/updates/mercur-1-0-release)**
## Why Choose Mercur?
- Full Ownership: Unlike SaaS platforms, you own your
marketplace with no transaction fees or vendor lock-in
- Modern Foundation: Built on MedusaJS, offering a modern
tech stack that developers love
- Beautiful by Default: Create stunning storefronts without
sacrificing customization
## Power Any Marketplace Model
- Custom B2B Marketplace: Build enterprise-grade platforms
with specialized workflows
- Custom B2C Marketplace: Create engaging consumer
marketplaces with modern UX
- eCommerce Extension: Transform your store into a
marketplace (coming soon)

ย
# Ready-to-go marketplace features
Storefronts for Marketplace
Customizable
storefronts designed for B2B and B2C with all elements
including browsing and buying products across multiple
vendors at once.
Discover
B2C
Storefront Repository -
๐๏ธ Check demo
Admin Panel
Control over whole marketplace:
setting product categories, vendors, commissions and rules
Vendor Panel
A powerful dashboard giving sellers
complete control over their products, orders, and store
management in one intuitive interface.
Discover
Vendor
Panel -
Contact us to get demo
Integrations
Built-in integration with Stripe
for payments and Resend for communication needs. More
integrations coming soon.

ย
## Quickstart
**Step 1**: Install `mercur-cli` using NPM:
```bash
npm i -g mercur-cli
```
**Step 2**: Run CLI installation:
```bash
mercur-cli install
```
or
```bash
npx mercur-cli install
```
The script will guide you through the installation process.
You will have to enter project name and database connection
parameters. Also, you'll be asked if you want to install
Mercur Storefront and Vendor panel.
**Step 3**: After installation is done, move to the project
catalog and start the servers:
```bash
cd
mercur-cli dev
```
ย
## Prerequisites
- [Node.js v20+](https://nodejs.org/en/download)
- [Yarn](https://yarnpkg.com/getting-started/install)
- [PostgreSQL](https://git-scm.com/downloads)
- [Git CLI](https://www.postgresql.org/download/)
# Resources
#### Learn more about Mercur
- [Mercur Website](https://www.mercurjs.com/)
- [Mercur Docs](https://docs.mercurjs.com/introduction)
#### Learn more about Medusa
- [Medusa Website](https://www.medusajs.com/)
- [Medusa Docs](https://docs.medusajs.com/v2)