Official Blocks

Blocks are modular pieces of marketplace functionality — API routes, workflows, UI pages, and data models. Each block is copied directly into your project. You own the code.

bunx @mercurjs/cli@latest add <block-name>

⭐

reviews

Product and seller reviews with ratings, customer/vendor/admin API routes, and workflows.

moduleworkflowapiadminvendor

👥

team-management

Team member management with invitations, roles, and vendor portal pages.

moduleworkflowapivendor

🔖

wishlist

Customer wishlist with product bookmarking, pricing context, and store API endpoints.

moduleworkflowapi

🔔

vendor-notifications

Vendor notification feed with bell icon in the navbar and a vendor API endpoint.

apivendor

🔍

algolia

Algolia search integration with product indexing, event-driven sync, and store search API.

moduleworkflowapi

🔎

meilisearch

Meilisearch search integration with product indexing, seller moderation sync, filtering, and store/admin API.

moduleworkflowapisubscriber

✅

requests

Admin approval system for entity requests — list, review, accept or reject submissions.

workflowapiadminvendor

📦

product-import-export

CSV product import & export for vendors. Includes API routes, workflows, and portal drawers.

workflowapivendor

💬

vendor-chat

TalkJS chat integration for vendors — API endpoint for seller conversations and a Messages page.

apivendor

Blocks are copied directly into your project — no runtime dependencies on Mercur. After installing, follow the setup steps in the Developer Guide. Want to build your own? See the Registry Guide.

Quick Start

Install a block

bunx @mercurjs/cli@latest add reviews

This copies the block source code into your project:

src/
├── modules/reviews/          # Data model and service
│   ├── models/
│   ├── service.ts
│   └── index.ts
├── workflows/reviews/        # Business logic
│   ├── create-review.ts
│   └── index.ts
├── api/
│   ├── admin/reviews/        # Admin API routes
│   ├── vendor/reviews/       # Vendor API routes
│   └── store/reviews/        # Storefront API routes
└── admin/
    └── routes/reviews/       # Admin dashboard pages

Search blocks

bunx @mercurjs/cli@latest search -q "reviews"

Compare local changes against registry

bunx @mercurjs/cli@latest diff reviews

Welcome