| name | mercur |
| description | Mercur/Medusa marketplace hub for my-marketplace/. Use whenever working on MercurJS, COM-010, registry blocks, Mercur CLI (search/view/add/diff), seller seeds, medusa-config, admin or vendor dashboards (src/routes), forms, tabbed wizards, @medusajs/ui conformance, or Mercur 1.x→2.0 migration — even if the user only says checkout, seller, block, or admin page. Always load this skill for any my-marketplace/ task before inventing custom code.
|
| version | 2.0.0 |
Mercur Marketplace Hub
Single entry point for Mercur work in my-marketplace/. Load topic references on demand — do not paste them into responses.
Not Supabase — catalog, sellers, checkout, and Stripe live on Mercur Postgres (:5433), separate from iPix platform Supabase.
Read first
my-marketplace/CLAUDE.md — task router, registry-first workflow, verificationmy-marketplace/AGENTS.md — CLI quick reference
Task router
| User intent | Read |
|---|
| CLI: create, init, search, view, add, diff | references/cli.md |
| Install, update, or verify registry blocks | references/blocks.md |
| Custom admin/vendor pages, routing, list/detail | references/dashboard-page-ui.md |
| Create/edit forms, validation, submit guards | references/dashboard-form-ui.md |
| Tabbed wizards, multi-step flows | references/dashboard-tab-ui.md |
Reusable UI, @medusajs/ui, component choice | references/medusa-ui-conformance.md |
| Migrate Mercur 1.x → 2.0 | references/migration.md |
Decision tree
my-marketplace task
├─ New feature? → search registry first (cli.md) → block match? (blocks.md)
├─ Backend API/modules/workflows → packages/api/CLAUDE.md
├─ Admin UI → page (dashboard-page-ui) → form? (dashboard-form-ui) → tabs? (dashboard-tab-ui)
├─ Any custom UI → medusa-ui-conformance.md first
└─ Legacy 1.x port → migration.md
Documentation
- MCP (preferred):
mercur → https://docs.mercurjs.com/mcp
- Index:
my-marketplace/docs/mercur/llms.txt
- Full dump:
my-marketplace/docs/mercur/llms-full.txt
- Refresh:
bash my-marketplace/scripts/fetch-mercur-docs.sh
Hard contracts (starter)
- Custom admin/vendor routes:
src/routes/**/page.tsx — not src/pages (mercurDashboardPlugin scans src/routes only)
- CLI registry commands: project root (where
blocks.json lives)
- Medusa commands:
packages/api (bunx medusa db:generate, db:migrate)
- Never accept CLI overwrite of
middlewares.ts — merge manually (see blocks.md)
- Secrets: Infisical
/mercur/api — never commit .env
Verification (typical)
cd my-marketplace/packages/api && yarn build
yarn seed:ipix-catalog
After block install or route changes: bun run dev from packages/api, then admin/vendor vite build if UI touched.
