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.
[ MEDUSA / 12 POSTS ]
Medusa articles
Guides, architecture deep-dives and production notes on MedusaJS — the open-source, TypeScript-native commerce platform we build on.
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.
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.
Scaling Medusa: What Breaks First and How to Fix It
Traffic does not break Medusa — the database does, then the workers, then the catalog queries. The bottlenecks in the order you will meet them.