Spectrum 1 → Spectrum 2 migration

Upgrade sp-* Spectrum 1 components (@spectrum-web-components/*) to swc-* Spectrum 2 components (@adobe/spectrum-wc).

You do not have to migrate everything at once. Gen 1 and Gen 2 coexist in the same app — <sp-badge> and <swc-badge> are independent custom elements. Migrate one component (or one screen) at a time.

TL;DR

1. Install @adobe/spectrum-wc alongside your existing @spectrum-web-components/* packages.
2. Switch Gen 1 to the spectrum-two theme so it aligns visually with Gen 2.
3. Add the Gen 2 stylesheet and swc-theme classes to your application root.
4. Load Adobe Clean Spectrum VF (the Spectrum 2 font).
5. Replace <sp-*> elements with <swc-*> one component at a time, following each component's migration guide.
6. Once no <sp-*> elements remain, remove Gen 1 packages, theme imports, and <sp-theme>.