v2.2.1

Gerstep/cybosv2.2.1Jul 28, 2026by github-actions[bot]

AI Summary

This release transforms Mercur into a complete end-to-end marketplace by introducing a CLI-based Next.js B2C storefront, a live demo environment, and targeted vendor promotions. It also resolves critical bugs related to pagination, checkout crashes, and Stripe payouts.

Key Highlights

  • CLI storefront scaffolding with Next.js B2C support
  • Live demo available at demo.mercurjs.com
  • Vendor offer-targeted promotions
  • Storefront cache revalidation
  • Multi-vendor seed data

New Features

  • Optional Next.js B2C marketplace storefront
  • Live marketplace demo
  • Vendor offer-targeted promotions
  • Multi-vendor seed data
  • Rebranded Medusa mentions to Mercur

Full Release Notes

## Mercur v2.2.1 🚀

This release makes Mercur a **complete, end-to-end marketplace out of the box** — you can now scaffold the storefront alongside the API, admin, and vendor panels, and see the whole thing running live before you write a line of code.

### 🛍️ A storefront, right from the CLI

`create-mercur-app` now offers an **optional Next.js B2C marketplace storefront** as part of the setup flow. Choose it during scaffolding and you get a fully wired shopper-facing frontend — multi-vendor catalog, offers, checkout — connected to your marketplace automatically.

```bash
bun create mercur-app@latest my-marketplace
# → pick the storefront step when prompted
```

### 🌐 See it live: [demo.mercurjs.com](https://demo.mercurjs.com)

Want to explore the full marketplace experience before installing anything? We now have a **live demo** running the complete stack — storefront, multiple vendors, real products — so you can click through exactly what you'll ship.

### ✨ Highlights

- **Vendor offer-targeted promotions** — sellers can now scope promotions to specific offers.
- **Storefront cache revalidation** — the basic template revalidates on product and offer events, so the storefront stays fresh automatically.
- **Multi-vendor seed data** — a richer footwear catalog across multiple vendors in the basic template, so a fresh install already looks like a real marketplace.

### 🐞 Fixes

- **vendor**: products list now paginates past the first page (#1299)
- **promotions**: aligned admin & vendor buy-get and rules with Medusa (#1298); fixed checkout crash with sellerless (admin) promotions (#1284)
- **store**: list products with an empty `product_seller` allowlist (#1292)
- **admin**: delete all of a store's offers per product, and show the store name (#1288)
- **payout**: reconcile Stripe accounts forward instead of orphaning on failure (#1266)
- **product-attribute**: mirror upserted attribute values onto the shared variant-axis option (#1283)
- **create-mercur-app**: pin `@mercurjs` deps for standalone scaffolds and inject the seeded publishable key into the storefront env (#1287, #1296)
- **i18n**: rebranded remaining Medusa mentions to Mercur across all locales (#1236)

**Full changelog:** https://github.com/mercurjs/mercur/compare/v2.2.0...v2.2.1

### 💜 Thank you

Huge thanks to everyone in our **[Discord](https://discord.gg/mercurjs)** and everyone who opened issues and shared feedback on **GitHub** — your reports, reproductions, and ideas directly shaped this release. Many of the fixes above exist because you took the time to tell us what was breaking and what you needed. Mercur is built in the open, with you, and we're grateful for it. 🙏

Keep the feedback coming — jump into Discord or open an issue anytime.