v2.2.1: Storefront scaffolding & offer-targeted promotions

Mercur 2.2.1 makes the platform 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.

What's New

Demo

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.

‍

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.

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

Vendor Panel

• Added offer-targeted promotions - sellers can scope a promotion to specific offers instead of only product- or store-wide rules.

Storefront

• Added automatic cache revalidation on product and offer events to the basic storefront template.
• Added a richer multi-vendor seed catalog to the basic template.

What's Fixed

Admin, Vendor & Storefront

• Fixed store offer deletion to remove all of a product's offers at once, and corrected the displayed store name.
• Fixed Stripe payout reconciliation to retry forward instead of orphaning the account on failure.
• Fixed products list pagination past the first page.
• Aligned admin and vendor buy-get promotion rules with Medusa.
• Fixed checkout crash caused by sellerless (admin) promotions.
• Fixed product listing when a product's seller allowlist is empty.

Other

• Pinned @mercurjs dependency versions for standalone create-mercur-app scaffolds.
• Fixed missing publishable key injection into the storefront env for standalone scaffolds.
• Rebranded remaining Medusa mentions to Mercur across all locales.
• Fixed upserted attribute values to mirror onto the shared variant-axis option.

‍