Testing Medusa: What to Test, What to Skip, and How
Commerce code moves money, so untested checkout logic is a liability. A pragmatic test strategy — what earns its keep, and what is theatre.
[ Field notes ]
Commerce engineering field notes
Deep guides on MedusaJS, headless commerce and replatforming — architecture, migrations, payments and the production details nobody writes down.
Observability for Medusa: Logs, Traces and the Alerts Worth Having
Self-hosting means owning the question 'is checkout working?'. Structured logging, tracing, the four metrics that matter and alerts that do not cry wolf.
Caching Medusa: What to Cache, Where, and What Never To
Four cache layers, one rule about carts, and the invalidation strategy that stops a price change taking twelve hours to appear.
Integrating Medusa with Sanity: Who Owns Which Field
The hard part of a commerce-plus-CMS setup is not the sync. It is deciding which system owns each field — and then never letting both own one.
Search in Medusa: Algolia, Meilisearch and Keeping the Index Fresh
Database search stops working sooner than you expect. Choosing an engine, building the index, and the sync strategy that survives a bulk import.
Selling Digital Products with Medusa: Delivery, Licensing and VAT
No shipping, no inventory, and a set of problems physical goods never have: secure delivery, licence enforcement, and tax charged where the customer is.
Building a Marketplace on Medusa: Vendors, Splits and Payouts
Multi-vendor commerce means splitting one customer order into several vendor orders, and moving money to people who are not you. The model and the money mechanics.
The US Vape Crackdown and Shopify: Why Brands Are Migrating to Medusa
Shopify Payments prohibits nicotine. The PACT Act killed your shipping options. Here is what actually happens when a vape brand gets deplatformed — and the migration path off Shopify onto self-hosted Medusa.
Building Subscriptions on Medusa: Billing Cycles, Dunning and Churn
Recurring billing is a scheduling problem with money attached. The data model, the renewal workflow, and the failure handling that determines involuntary churn.
B2B Commerce on Medusa: Companies, Approvals, Quotes and Net Terms
The four capabilities that separate B2B from DTC, modelled as Medusa modules and workflows — with the data model that makes approvals work.
Multi-Currency Pricing in Medusa: Price Lists and Rounding
Explicit prices per currency, price lists for sales and customer-group pricing, and the minor-unit arithmetic that makes zero-decimal currencies interesting.
Medusa Multi-Region: Currencies, Tax and Selling Internationally
Regions carry currency, tax, payment methods and shipping. How to model international selling without accidentally creating twelve stores.