Mercur
Open Source Marketplace Platform

Mercur | Docs

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

We are actively working on Mercur 2.0 — a major rearchitecture of the platform. @vholik, @Si3r4dz, and @gtomaka are building the next generation of Mercur with a new modular, block-based architecture.

What's new in 2.0:

• Block-based architecture — reusable modules, workflows, API routes, and UI extensions installable via CLI
• Vendor portal — a standalone React-based vendor dashboard
• Dashboard SDK — Vite plugin with file-based routing and hot module reloading
• New CLI — @mercurjs/cli for scaffolding projects, adding blocks, and managing registries
• Full code ownership — code is copied into your project, no black-box dependencies

Try the canary:

npm install @mercurjs/cli@canary

Canary versions are published on every release and are intended for early testing and feedback only. APIs and behavior may change without notice between canary releases.

• 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

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

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.

Step 1: Create a new Mercur project and start the development server:

npx @mercurjs/cli create my-marketplace

Step 2: Start the development server:

cd my-marketplace
npm run dev

Step 3: Access your marketplace:

• Backend API: http://localhost:9000
• Admin Panel: http://localhost:7000
• Vendor Panel: http://localhost:7001

• Node.js v20+
• PostgreSQL
• Redis
• Git CLI

Mercur is an Open Source project and we encourage everyone to help us making it better. If you are interested in contributing to the project, please read our Contributing Guide and Code of Conduct.

If you have any questions about contributing, please join our Discord server - we are happy to help you!

Discovered a 🐜 or have feature suggestion? Feel free to create an issue on Github.

• Mercur Website
• Mercur Docs

• Medusa Website
• Medusa Docs