v2.2.1

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.

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

🌐 See it live: 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: v2.2.0...v2.2.1

💜 Thank you

Huge thanks to everyone in our Discord 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.