Skip to content

The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you own.

1.8 KB
Raw Blame

Mercur Marketplace Project

This is a Mercur marketplace project — an open-source AI-native multi-vendor marketplace built on MedusaJS v2.

Read the docs first

Before any non-trivial change, read the bundled documentation — it ships as a dependency, so it is offline and version-matched to this project's packages:

  1. Index: node_modules/@mercurjs/docs/llms.txt
  2. Full pages: node_modules/@mercurjs/docs/content/**/*.mdx

It covers the domain model (sellers, products, offers, attributes, commissions, payouts, order groups), the CLI, the typed API client, the dashboard SDK, and module references. Don't guess at an API or data model the docs already describe.

Project Structure

├── packages/api/         # Backend API — modules, workflows, links, subscribers
├── apps/admin/           # Admin dashboard — operator panel
├── apps/vendor/          # Vendor portal — seller dashboard
└── blocks.json           # Block configuration and registry aliases

Documentation

Configuration Files

  • blocks.json — block configuration and registry path aliases
  • packages/api/medusa-config.ts — MedusaJS configuration
  • apps/admin/vite.config.ts — admin dashboard build config
  • apps/vendor/vite.config.ts — vendor portal build config

Getting Started

bun run dev

This starts:

  • Backend API at http://localhost:9000
  • Admin Panel at http://localhost:9000/seller
  • Vendor Panel at http://localhost:9000/dashboard