With the release of Progressive Web App (PWA) Kit version 3.0, we introduced two new independently versioned packages to the platform, retail-react-app and commerce-sdk-react.
In addition, depending on your project's build, your storefront may have additional dependencies on the commerce-sdk-isomorphic package or the plugin_slas Storefront Reference Architecture (SFRA) cartridge.
Check this table to make sure you're using compatible versions of PWA Kit, retail-react-app, commerce-sdk-react, commerce-sdk-isomorphic, and plugin_slas.
| PWA Kit | retail-react-app | commerce-sdk-react | commerce-sdk-isomorphic | plugin_slas | Notable Changes |
|---|---|---|---|---|---|
| v3.10.x | v6.1.x | v3.3 or later | v3.3 or later | v7.4 | Retail react app<br/><ul><li>Source maps support for both client and server on Managed Runtime. See Debug Using Source Maps.</li><li>Data Cloud integration with PWA Kit events.</li><li>Page meta data tags from Business Manager now supported on Product Detail Pages (PDP) and Product List Pages (PLP).</li><li>Improved password management with Confirm New Password field in Reset & Change Password flows.</li><li>Enhanced performance logging for server-timing headers.</li><li>Fixed hreflang alternate links and accessibility issues.</li></ul>Commerce-sdk-react<ul><li>Fixed guest login token handling with hybrid authentication.</li><li>Improved cache management during logout.</li><li>Added support for custom parameters in SLAS authorization calls.</li>See v3.10.0 (retail-react-app@6.1.0 and commerce-sdk-react@3.3.0) on GitHub. |
| v3.9.x | v6.x | v3.2 or later | v3.2 or later | v7.4 | Retail react app<br/><ul><li>Passwordless and social login support.</li><li>Password reset support.</li><li>Do not track support.</ul> |
| v3.8.x | v5.x | v3.1 or later | v3.1 or later | v7.4 | Retail react app<ul><li>Shopper context integration</li><li>Active data tracking set to true by default.</li></ul><br/>Commerce-sdk-react<br/><ul><li>Attach dwsid to SCAPI requests</li><li>Remove OCAPI session bridging.</li></ul> |
| v3.7.x | v4.x | v3.x | v3.x | v7.3 | Commerce-sdk-react<ul><li>SLAS now requires channel_id.</li><li>Shopper context now requires siteId.</li><li>Upgrade to commerce-sdk-isomorphic v3.x</li></ul> |
| v3.6.x | v3.x | v2.x | v2.x | v7.3 | Retail react app<br/><ul><li>Product tile rework.</li></ul><br/>Commerce-sdk-react<ul><li>Upgrade to commerce-sdk-isomorphic v2.x</li></ul> |
| v3.5.x | v2.x | v1.4.0 < v2.x | v1.10 | v7.3 | Commerce-sdk-react<ul><li>SLAS private client support.</li><li>Reworks how sessions are transferred between SFRA and PWA so OCAPI /sessions call is not required on the PWA</li></ul> |
| v3.1.1 - v3.4.x | v2.x | v1.0.2 < v1.4.0 | v1.10 | v7.0 - v7.2 | Retail react app<ul><li>Page designer types migrated to commerce-sdk-react</li></ul> |
| v3.0.0 - v3.1.0 | v1.x | v1.0.0 - v1.0.1 | v1.10 | v7.0 - v7.2 | Initial release of PWA Kit 3.x |
For more information about the features available in various versions of PWA Kit and retail-react-app, see the Composable Storefront Release Notes.
note: Projects on PWA Kit v2 are not compatible with retail-react-app.
Projects on PWA Kit v2 may consume commerce-sdk-react as a customization. See the Upgrade to v3 guide for more information