Mantra Seeds
Production headless commerce: Vercel-Commerce-derived Next.js 16 storefront on a custom-extended Medusa v2 backend.
Mantra Seeds is shipped client work: production headless commerce for a regulated vertical, built end to end (storefront, backend, admin, and payments). Off-the-shelf platforms couldn't carry the requirements (age-gating, Square rather than the default Stripe path, and reviews, wishlists, search, and invoices that behave like first-party product), so the platform itself was extended: nine custom Medusa v2 modules, ~30 workflows, and a hand-written Square payment provider with signature-verified webhooks and money-precision handling.
The build is based on my CrowCommerce Medusa template and serves as its production proving ground. The template supplies the storefront and backend foundations, and this client work exercises them under real traffic, real payments, and a real catalog. The source lives in a private client repository, so this case study links to the template it grew from rather than to code.
Highlights
- 01
Nine custom Medusa v2 modules: product-review (verified-purchase + admin responses), wishlist (guest + share tokens), invoice, newsletter, presence, resend, meilisearch, product-media, and square-payment; plus ~18 subscribers, ~30 workflows, custom admin widgets/routes, and five module links
- 02
Hand-written Square payment provider extending Medusa's AbstractPaymentProvider: full initiate/authorize/capture/cancel/refund/getStatus lifecycle, HMAC webhook signature verification, BigNumber money handling, Sentry + PostHog instrumentation, and unit + sandbox tests
- 03
Meilisearch product search wired to a Cmd+K command palette, with a provider-agnostic checkout shell decoupling the UI from Square vs. Stripe
- 04
On-demand React-PDF invoice generation rendered from order data through a dedicated Medusa workflow
- 05
WebGL/OGL circular gallery and GSAP motion system, a CSP nonce proxy, Zod-validated server actions, PII redaction, feature flags, and age-gating for a regulated vertical
- 06
Transactional email + newsletter (Resend Audience + Buttondown) with an HMAC-signed abandoned-cart recovery cron