Medusa Storefront Performance: Where the Milliseconds Actually Go
Over-fetching, waterfalls and unoptimised images account for most of a slow headless storefront. How to find them and what to do about each.
[ Field notes / page 3 of 5 ]
Field notes — page 3
Shipping cadence beats velocity
Why we measure cadence — not story points — for every engagement.
Medusa Storefront SEO: Structured Data, Canonicals and Facets
Headless means you own every SEO decision, including the ones a hosted platform used to make. Metadata, Product schema, canonical rules and the faceted-navigation trap.
Deploying Medusa on AWS: ECS, RDS and the Parts That Bite
A production AWS architecture for Medusa — ECS Fargate, RDS, ElastiCache, S3 — plus the networking and migration details that turn a two-day job into a two-week one.
Deploying Medusa on Railway: The Fastest Production Setup
Railway is the shortest path from a Medusa repository to a production deployment that is actually correct. The full setup, including the worker service everyone forgets.
Dockerising Medusa: A Production Image That Is Not 2GB
A multi-stage Dockerfile for Medusa v2, a compose file for local development, and the build-memory problem that catches every team once.
Medusa Environment Variables and Configuration, Done Properly
Every variable Medusa reads, which ones are security-critical, and how to structure configuration so a missing value fails at boot instead of at checkout.
Three things to fix before going live on Hydrogen
Edge runtime gotchas, cart hydration, and the SEO trap most teams miss.
Medusa Database Migrations: Generating, Reviewing and Deploying Safely
Generated migrations are only as safe as your review of them. How Medusa migrations work, and the expand-and-contract pattern that keeps rolling deploys from failing.
Stripe with Medusa: Setup, Elements and Webhooks That Work
Configuring the Stripe module, wiring Payment Elements into a Next.js checkout, and the webhook and 3D Secure details that decide whether payments reconcile.
The Medusa Checkout Flow: Every Step, and Where It Breaks
Address, shipping, payment session, complete. The four stages of a Medusa checkout, the state machine underneath, and the failure modes that cost orders.
Deploying Medusa to Production: Architecture, Checklist and Pitfalls
What a production Medusa deployment actually needs — process separation, Redis, migrations, health checks — and the four mistakes that cause the first outage.