React Spectrum v3 to S2 migration

Upgrade React Spectrum v3 codebases to S2 by following these eight steps in order.

Scope

This skill covers only the React Spectrum v3 (S1) to S2 migration. Do not perform major dependency upgrades such as React version bumps (e.g. React 16→17, 17→18, 18→19) as part of this migration. If the project needs a major dependency upgrade, note it as a recommended follow-up in the final report (Step 8) rather than attempting it during migration.

Step 1: Inspect the codebase

• Search package manifests for @adobe/react-spectrum, @react-spectrum/*, and @spectrum-icons/*.
• Note the package manager (npm, yarn, pnpm) from the lockfile.
• Identify the bundler used by the migration target (Parcel, Vite, webpack, Next.js, Rollup, ESBuild).
• In monorepos, inspect the specific package or app being migrated rather than the workspace root.
• Find app entrypoints, root providers, shared test wrappers, toast setup, and any defaultTheme usage.

See Prerequisites for the full inspection checklist and minimum tool versions.

Step 2: Install @react-spectrum/s2