Field notes
Insights
Decision-stage notes for operators and senior engineers — migration timelines, stack comparisons, integration patterns, and what we ship in production.
Medusa · Payload · Next.js · Postgres · Stripe · Claude — written for the buyer and the engineer in the same room.
Archive
23- 02
Claude API Cost on Payload CMS: The Four Levers We Pull Before the Bill Hits €500/Month
Most AI features on Payload do not fail on quality — they fail on a bill that quietly triples in month three. Here is the token budget we set before writing a single hook, and the four levers we pull to hold it.
13 Jul 2026 · AI Automation
13 Jul 2026AI Automation - 03
Payload's Generated Types Are the Contract: The Zod + Server Action Pattern We Ship Instead of DTOs
Payload generates the types. Zod derives from them. Server Actions accept the same shape the Local API returns. Here is the pattern, the four failure modes it removes, and the one place we still validate by hand.
04 Jul 2026 · Payload Engineering
04 Jul 2026Payload Engineering - 04
AI Feature Observability on Payload and Medusa: The Four Signals We Wire on Day One
Every Claude feature we ship on Payload or Medusa gets four signals wired before it sees production traffic. Skip any of them and the regression will be silent — and expensive.
01 Jul 2026 · Production Hardening
01 Jul 2026Production Hardening - 05
Alt Text on Autopilot: The Payload + Claude Vision Pipeline We Ship for 10,000-Image Archives
Alt text is the AI workflow with the highest ROI and the lowest glamour. Here is the exact Payload upload-hook, queue, and Claude Vision pipeline we ship — including the locales we still refuse to automate.
28 Jun 2026 · AI Automation
28 Jun 2026AI Automation - 06
Claude vs Gemini vs GPT-4o-mini for Catalog and Editorial AI: The €/1k-SKU Cost Framework We Use
Operators keep asking which model to wire into their Payload or Medusa pipeline. The honest answer: the model name moves the bill less than batching, caching, and structured outputs do. Here is the framework we use on real client work, with line-item numbers.
22 Jun 2026 · AI Automation
22 Jun 2026AI Automation - 07
Streaming Claude from Server Actions into Payload: The Resume-on-Refresh Pattern We Ship
Streaming Claude from a Next.js Server Action looks fine on localhost and falls apart the first week in production. Here is the shape we ship instead: kick off the job, stream into Postgres via Payload, let the client subscribe to the row.
19 Jun 2026 · AI Engineering
19 Jun 2026AI Engineering - 08
RAG Support Copilots on Medusa: The Retrieval Shape We Ship Before Claude Sees an Order
Support copilots do not hallucinate refunds because the model is weak. They hallucinate because retrieval is shaped wrong. Here is the three-call retrieval pattern we wire on Medusa + Payload before Claude generates a token.
13 Jun 2026 · AI Engineering
13 Jun 2026AI Engineering - 09
Prompt Injection on Commerce Copilots: Five Guardrails We Wire Before Claude Touches a Medusa Order
Customer-facing copilots on Medusa and Payload fail in five predictable ways once a stranger can type into them. Here are the guardrails we ship before any tool call mutates an order or publishes a draft.
10 Jun 2026 · AI Engineering
10 Jun 2026AI Engineering - 10
AI Translation in Payload: The Publish-Hook Pattern We Ship (and the Locale We Refuse to Automate)
Most Payload teams wire Claude into localized fields, ship a flood of machine-translated content, then quietly roll it back. Here is the narrower hook shape we ship instead — locked drafts, editor sign-off, token math, and the one locale we never let a model touch.
07 Jun 2026 · AI Automation
07 Jun 2026AI Automation - 11
Internal Linking on Autopilot: The Payload + Claude Pipeline We Wire for Archives Past 400 Articles
Most editorial teams stop linking internally after article 50. Here is the Payload afterChange hook, pgvector retrieval, and Claude scorer we wire so suggestions land in the editor — never auto-published — with one-click insert into Lexical.
01 Jun 2026 · AI Automation
01 Jun 2026AI Automation - 12
Catalog Enrichment on Medusa with Claude: The Import-Time Pipeline We Ship for 2,000+ SKU Brands
Bolting AI onto live product pages burns trust by week three. Here is the import-time enrichment pipeline we wire into Medusa with Claude, structured outputs, and a Payload approval queue — including token cost per 1,000 SKUs and the regressions it prevents.
30 May 2026 · AI Automation
30 May 2026AI Automation - 13
Four AI Workflows We Wire Into Payload for Editorial Teams (and the One We Refuse to Ship)
Content teams keep asking us to 'add AI to the CMS.' That framing buys nothing. Here are the four Payload automations that actually move editorial velocity — and the one we refuse to ship, with the wiring shape and token math for a team publishing 40 articles a month.
26 May 2026 · AI Automation
26 May 2026AI Automation - 14
GDPR + Payload: The Field-Level Pattern That Passes a Data Protection Audit
The field-level encryption, automated deletion hooks, and audit trail patterns that make Payload CMS applications survive a data protection officer's review — with the specific schema choices that turn right-to-be-forgotten requests into one-line operations.
22 May 2026 · Production Hardening
22 May 2026Production Hardening - 15
Stripe Webhook → Postgres Ledger: The 50-Line Pattern That Survives an Audit
Every Series B audit asks the same question about your payment data: can you prove this transaction happened, when it happened, and that you recorded it exactly once? Here's the webhook-to-ledger pattern that passes.
19 May 2026 · Integration Patterns
19 May 2026Integration Patterns - 16
Custom Shipping Rules in Medusa: The Multi-Carrier Pattern That Scales Past Flat-Rate
When D2C brands outgrow flat-rate shipping, they need inventory-aware location routing, weight-based carrier selection, and real-time rate shopping. Here's the Medusa shipping service pattern that handles complex fulfillment rules without losing sales to API timeouts.
16 May 2026 · Medusa Engineering
16 May 2026Medusa Engineering - 17
Payload Hooks That Prevent Production Fires: The 8 We Ship on Every Project
The specific Payload hook patterns we implement on every project to prevent stale draft caches, orphaned relationships, and broken webhook deliveries before they reach production.
14 May 2026 · Payload Engineering
14 May 2026Payload Engineering - 18
Postgres Connection Pooling on Serverless: The PgBouncer vs Supabase vs Neon Reality Check
Why 100 concurrent Vercel functions kill your database, and the production patterns that scale to 10K connections without breaking your budget.
12 May 2026 · Postgres Patterns
12 May 2026Postgres Patterns - 19
Next.js Server Actions + Payload Local API: The 200-Line Pattern That Replaces tRPC
How to wire Next.js Server Actions directly to Payload's Local API for type-safe mutations, eliminating the need for tRPC or external API routes in content-heavy applications.
12 May 2026 · Integration Patterns
12 May 2026Integration Patterns - 20
Payload Blocks vs Collections: The Content Architecture Decision That Breaks at 1,000 Articles
When to model content as reusable blocks vs separate collections in Payload CMS — with real schema examples and performance implications for content teams publishing at scale.
12 May 2026 · Payload Engineering
12 May 2026Payload Engineering - 21
Stripe vs Adyen vs Mollie for EU D2C: The €500k Revenue Breakpoint (and Hidden Costs)
Payment processor economics shift dramatically at €500k annual volume in Europe. Stripe's simplicity costs 0.3-0.8% more than Adyen, but Adyen's complexity tax hits smaller teams hard. Real-world fees, integration weeks, and revenue thresholds where switching pays back.
12 May 2026 · Vendor Choice
12 May 2026Vendor Choice - 22
AI Search on Medusa: When It Beats Algolia (and the $4k/Month Reality Check)
Our token economics breakdown for AI-powered search on Medusa JS: when semantic search justifies $4k/month in OpenAI costs vs $400/month Algolia, and the hybrid approach that cuts spend 60% while improving long-tail conversion 23%.
12 May 2026 · AI Rollout
12 May 2026AI Rollout - 23
Payload vs Sanity for Content Teams: Why We Switched (and the 3-Month Cost Breakdown)
Content teams publishing 20+ articles monthly hit workflow friction with Sanity Studio that Payload's admin eliminates. Here's what the switch costs and when it pays back.
12 May 2026 · Vendor Choice
12 May 2026Vendor Choice - 24
Shopify Plus to Medusa: What a 6-Week Migration Actually Costs (and When It Pays Back)
Break down the real financial math behind migrating a high-SKU D2C brand from Shopify Plus to Medusa — migration costs, ongoing savings, revenue impact, and the 18-month payback timeline most CFOs need to see.
12 May 2026 · Replatform
12 May 2026Replatform