|
|
||
|---|---|---|
| .claude/skills | ||
| .github | ||
| .mercur/_generated | ||
| apps | ||
| docs | ||
| integration-tests | ||
| packages | ||
| templates | ||
| .gitignore | ||
| .npmrc | ||
| .oxlintrc.json | ||
| bun.lock | ||
| claude-progress.md | ||
| CLAUDE.md | ||
| CNAME | ||
| CODE_OF_CONDUCT.md | ||
| context7.json | ||
| CONTRIBUTING.md | ||
| eslint.config.mts | ||
| feature_list.json | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
| registry-item.json | ||
| registry.json | ||
| RELEASING.md | ||
| ROADMAP.md | ||
| SECURITY.md | ||
| session-handoff.md | ||
| turbo.json | ||
What is Mercur?
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.
What's new in Mercur 2.0
Mercur 2.0 is a major rearchitecture of the platform built by @vholik, @Si3r4dz, and @gtomaka.
- 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
- CLI —
@mercurjs/clifor scaffolding projects, adding blocks, and managing registries - Full code ownership — code is copied into your project, no black-box dependencies
Using with AI Agents
Mercur is built to be AI-agent friendly. Your AI coding assistant can use these resources to understand and work with Mercur projects:
- MCP Server:
https://docs.mercurjs.com/mcp— connect your agent for documentation search - llms.txt:
https://docs.mercurjs.com/llms.txt— machine-readable project summary - AGENTS.md: included in every project created with
mercurjs create— gives agents instant project context - Skills:
.claude/skills/shipped with templates — domain-specific patterns for Claude Code - AI Development Guide: docs.mercurjs.com/v2/ai-development/mcp
Why Choose Mercur?
- 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
Power Any Marketplace Model
- 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)
Ready-to-go marketplace features
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.
Quickstart
Step 1: Create a new Mercur project and start the development server:
bunx @mercurjs/cli@latest create my-marketplace
Step 2: Start the development server:
cd my-marketplace
bun run dev
Step 3: Access your marketplace:
- Backend API:
http://localhost:9000 - Admin Panel:
http://localhost:7000 - Vendor Panel:
http://localhost:7001
Prerequisites
Contribution
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.