Deployment Skill — Astro v6 + Cloudflare Workers

This skill covers the full deploy pipeline for Astro v6 + Cloudflare Workers projects. Use it when:

• Setting up a new project for deployment
• Connecting GitHub repo via Workers Builds (push-to-deploy)
• Deploying to preview or production
• Debugging 500 errors, build failures, or wrangler issues after deploy
• Updating dependencies and checking compatibility
• A deploy that previously worked starts failing

Key Facts

• Astro v6 + @astrojs/cloudflare v13 targets Workers only (Pages support was removed from the adapter)
• astro dev runs on the real workerd runtime — if it works locally, it works in production
• Static assets served by Workers are free and unlimited — only SSR requests count against quota
• Astro v6 includes Zod 4 built-in (import { z } from 'astro/zod') — no separate Zod dependency needed
• Astro Sessions auto-configure with Workers KV for multi-step form state persistence
• Use Astro Actions for type-safe form handling with built-in validation
• The fix-wrangler.mjs hack from Pages deployments is no longer needed — delete it