React Spectrum v3 to S2 migration

Use this skill to upgrade React Spectrum v3 codebases to React Spectrum S2. Work codemod-first by default: inspect the repo, run the non-interactive codemod, then resolve the manual follow-up work it cannot finish safely.

Inspect first

• Search package manifests and source for @adobe/react-spectrum, @react-spectrum/* packages, and @spectrum-icons/*.
• In monorepos or mixed-tooling repos, inspect the target package or app instead of assuming the workspace root has all the information. Determine the package manager and runtime bundler at the migration target level when needed.
• Find app entrypoints, standalone pages, alternate render roots, embedded sub-apps, utility apps, test-only render targets, root providers, shared test wrappers, toast setup, dialog helpers, and any direct defaultTheme usage before running the codemod.
• Prefer --path for monorepos or partial rollouts. Use --components only when the user explicitly wants an incremental migration.

Upgrade workflow