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: 2 months 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 (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-15T09:58:33.000Z (2 months ago)
- Last Synced: 2025-05-15T10:04:47.740Z (2 months 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: 5.32 MB
- Stars: 457
- Watchers: 18
- Forks: 75
- Open Issues: 18
-
Metadata Files:
- Readme: README.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) 2.0, 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.
## 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.
Integrations
Built-in integration with Stripe for payments and Resend for communication needs. More integrations coming soon.
## Quickstart
#### Setup Medusa project
```bash
# Clone the repository
git clone https://github.com/mercurjs/mercur.git
# Change directory
cd mercur
# Install dependencies
yarn install
# Go to backend folder
cd apps/backend
# Clone .env.template
cp .env.template .env
# In the .env file replace user, password, address and port parameters in the DATABASE_URL variable with your values
DATABASE_URL=postgres://[user]:[password]@[address]:[port]/$DB_NAME
# For example:
DATABASE_URL=postgres://postgres:postgres@localhost:5432/$DB_NAME
# Setup database and run migrations
yarn medusa db:create && yarn medusa db:migrate && yarn run seed
# Generate OpenAPI client
yarn generate:oas
# Create admin user
npx medusa user --email --password
# Go to root folder
cd ../..
# Generate http-client interfaces
yarn codegen
# Start Mercur
yarn dev
```
## Prerequisites
- Node.js v20+
- PostgreSQL
- Git CLI
# 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)
