The story behind the project

Multi-Vendor Marketplace Accelerator

About illustration
About icon

What is Mercur

Mercur is the JavaScript open-source platform for building multi-vendor marketplaces. Built on top of Medusa.js, it simplifies the development of customized marketplaces.

Why Mercur

After seeing the rising trend in multi-vendor business models and setting up several marketplaces from scratch at Rigby, we wanted to eliminate the repetitive setup of marketplaces. The aim is to enable users to start a new marketplace in about five minutes, providing a strong starting point for anyone looking to build their own multi-vendor platform. Medusa is an amazing and strong foundation for building marketplaces but requires a few modifications to adjust to this business model. We wanted a faster way to get these platforms up and running — Mercur is that accelerator for building multi-vendor marketplace with Medusa.js as a core.

Goals

We aim to make Mercur adaptable for various marketplace types, such as rental or service marketplaces.

We also want to build an ecosystem of plugins tailored to multi-vendor setups, including solutions for payment distributions like Stripe. We want to publish all plugins adapted to the multi-vendor market under the namemedusa-mercur-... e.g. medusa-mercur-stripe. With this annotation, developers will always know that this is a plugin for the MVM.

Feel free to share your ideas on Medusa Discord, how you imagine the development of this project.

Project Components

Mercur Components

  • Core: The backbone of Mercur, handling the primary operations and data flow essential for marketplace functionality.


  • Admin: Provides a control panel for marketplace administrators to manage vendors, orders, settings, and more.


  • Vendor: A dedicated interface for vendors to manage their products, orders, and profile details.


  • Storefront: The frontend where customers browse products, place orders, and interact with the marketplace. It is a customized version of the Medusa.js Next.js Starter.

Project Features


  • Vendor Registration: Allows new vendors to sign up and await approval from marketplace administrators.


  • Vendor Profiles: Enables vendors to create and customize their profiles on the marketplace.


  • Vendor Authorization by Admin: Admins can review and authorize vendor registrations to maintain marketplace standards.


  • Order Splitting: Facilitates the distribution of orders among multiple vendors involved in a single transaction.


  • Vendor Shipping Management: Vendors can manage their shipping logistics independently within the platform.


  • Commission Management (Coming soon): Admins can set up and manage commission rates from vendor sales.

Roadmap

  • 1. Payment provider & Commission Management & Invoices


  • 2. Adjustments to Medusa 2.0!


  • 3. More coming soon

Getting started

Create a new Mercur project with just one command:

npx mercurjs-starter my-marketplace

You will be asked to select the project’s modules (admin / vendor / storefront) platform you wish to use. Once selected, the CLI will create project files in the directory matching your project name.


Find out more about project configuration from npm package description: NPM .

Support Mercur

Mercur is a community-driven, open-source initiative. We are committed to keeping it free and accessible by releasing it under the MIT License.

How to contribute:

  • Ideas: Allows new vendors to sign up and await approval from marketplace administrators.


  • Code: Enables vendors to create and customize their profiles on the marketplace.


  • Bug: Admins can review and authorize vendor registrations to maintain marketplace standards.


  • Spread the Word: Ensures users have permissions appropriate to their role within the marketplace.


  • Create Content: Facilitates the distribution of orders among multiple vendors involved in a single transaction.


  • Join the Community: Vendors can manage their shipping logistics independently within the platform.

License

Licensed under the MIT License.

The open source marketplace

Want to build Multi-Vendor Marketplace?

Start with Mercur. Set up your Medusa multi-vendor marketplace in 10 minutes.