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 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

# Clone the repository
git clone https://github.com/mercurjs/mercur.git

# 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 <email> --password <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
• Mercur Docs

Learn more about Medusa

• Medusa Website
• Medusa Docs