Repolode
Submit
mercurjs

mercurjs/mercur

Open-source, headless multi-vendor marketplace platform built on Medusa, adding vendors, offers, commissions and payouts to a commerce core.

Open-source alternative to:Mirakl

View on GitHubWebsite
Stars
1,855
Forks
468
Open issues
17
Last commit
4 days ago

What is it?

Mercur is a headless platform for building multi-vendor marketplaces. It extends the Medusa commerce core with vendor onboarding, multi-vendor catalogs where several sellers can list offers against the same product, commissions, and automated payouts. It supports B2C, B2B, and hybrid marketplace models.

The project ships admin and vendor dashboards built with React and Vite, along with a storefront layer and APIs for serving any frontend. Workflows, products, and vendor rules can be extended or overridden through its TypeScript plugin architecture. Integrations mentioned include Stripe Connect payouts, Resend email, and Algolia or Meilisearch search.

The stack runs as a Node.js application backed by PostgreSQL and Redis, so it can be deployed in containers, on Kubernetes, or on a managed cloud. This repository is the development monorepo; new projects are typically created with the mercur-app CLI.

Key features

  • 01Vendor onboarding with multi-vendor catalogs and offers on shared products
  • 02Commission rules and automated payouts, including Stripe Connect integration
  • 03Admin panel for operators and vendor panel for sellers, built with React and Vite
  • 04Headless, API-first architecture that works with any storefront
  • 05Extensible TypeScript plugin system for workflows and vendor rules
  • 06Built on Medusa for catalog, orders, payments, shipping, tax, and stock

Use cases

  • Launching a B2C or B2B marketplace where many vendors sell through one storefront
  • Replacing a per-transaction-fee marketplace SaaS with a self-hosted platform
  • Building a custom storefront that consumes Mercur's marketplace APIs

Quick start

  1. 1

    Create a new Mercur project

    bun create mercur-app@latest my-marketplace
  2. 2

    Start the development server

    cd my-marketplace bun run dev
  3. 3

    Open the Backend API, Admin Panel or Vendor Panel in your browser (localhost:9000)

Things to know

  • Requires PostgreSQL 13+ and Redis, plus Node.js 20+, so setup involves real infrastructure.
  • Enterprise features such as Buy Box, vendor KYC and split payouts are a separate licensed product, not part of the MIT core.

Topics

#ecommerce#marketplace#multi-vendor#headless-commerce#typescript#medusa#nodejs#postgresql#b2b-marketplace#composable-commerce

FAQ

What is mercur?
Open-source, headless multi-vendor marketplace platform built on Medusa, adding vendors, offers, commissions and payouts to a commerce core. Mercur is a headless platform for building multi-vendor marketplaces. It extends the Medusa commerce core with vendor onboarding, multi-vendor catalogs where several sellers can list offers against the same product, commissions, and automated payouts. It supports B2C, B2B, and hybrid marketplace models.
Is mercur free to use? What license does it have?
mercur is open source under the MIT license. Check the license terms before using it in commercial products.
Is mercur still maintained?
Actively maintained. The last commit to mercur was on Oct 16, 2026.
What can I use mercur for?
Launching a B2C or B2B marketplace where many vendors sell through one storefront Replacing a per-transaction-fee marketplace SaaS with a self-hosted platform Building a custom storefront that consumes Mercur's marketplace APIs
How do I install mercur?
Create a new Mercur project: bun create mercur-app@latest my-marketplace Start the development server: cd my-marketplace bun run dev Open the Backend API, Admin Panel or Vendor Panel in your browser (localhost:9000)
Where can I get mercur?
The source code and installation instructions are on GitHub: https://github.com/mercurjs/mercur

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects