The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you own.
TypeScript b2b-marketplacecomposable-commerceecommerceenterpriseheadless-commercemarketplacemedusamedusajsmulti-vendortypescript
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:
- Index:
node_modules/@mercurjs/docs/llms.txt - 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
- Bundled docs (read first):
node_modules/@mercurjs/docs/llms.txt→content/**/*.mdx - Online docs: https://docs.mercurjs.com
- MCP Server: https://docs.mercurjs.com/mcp — connect your AI agent for documentation search
- llms.txt (online): https://docs.mercurjs.com/llms.txt
Configuration Files
blocks.json— block configuration and registry path aliasespackages/api/medusa-config.ts— MedusaJS configurationapps/admin/vite.config.ts— admin dashboard build configapps/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