Astro v6 Upgrade Guide

This skill is based on the final Astro v6 upgrade guide and the Cloudflare adapter v13 migration.

Quick Start

1. Check Node version: Astro v6 requires Node 22.12.0 or higher. Check with node -v, and update .nvmrc / deployment config if needed. Ensure that you include CI workflows in this update if applicable.
2. Upgrade Astro and official integrations together:

   npx @astrojs/upgrade      # npm
   pnpm dlx @astrojs/upgrade # pnpm
   yarn dlx @astrojs/upgrade # yarn
   

3. Check for legacy content collections (see below). v5 supported legacy collections via backwards-compat even without the flag. v6 removes that entirely.
4. If deploying to Cloudflare: the @astrojs/cloudflare v13 upgrade has significant changes. Load cloudflare.md.
5. Fix any errors using this guide.

Check: Legacy Content Collections