PWA Compatibility Matrix

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 Kitretail-react-appcommerce-sdk-reactcommerce-sdk-isomorphicplugin_slasNotable Changes
v3.9.xv6.xv3.2 or laterv3.2 or laterv7.4Retail react app
  • Passwordless and social login support.
  • Password reset support.
  • Do not track support.
v3.8.xv5.xv3.1 or laterv3.1 or laterv7.4Retail react app
  • Shopper context integration
  • Active data tracking set to true by default.

Commerce-sdk-react
  • Attach dwsid to SCAPI requests
  • Remove OCAPI session bridging.
v3.7.xv4.xv3.xv3.xv7.3Commerce-sdk-react
  • SLAS now requires channel_id.
  • Shopper context now requires siteId.
  • Upgrade to commerce-sdk-isomorphic v3.x
v3.6.xv3.xv2.xv2.xv7.3Retail react app
  • Product tile rework.

Commerce-sdk-react
  • Upgrade to commerce-sdk-isomorphic v2.x
v3.5.xv2.xv1.4.0 < v2.xv1.10v7.3Commerce-sdk-react
  • SLAS private client support.
  • Reworks how sessions are transferred between SFRA and PWA so OCAPI /sessions call is not required on the PWA
v3.1.1 - v3.4.xv2.xv1.0.2 < v1.4.0v1.10v7.0 - v7.2Retail react app
  • Page designer types migrated to commerce-sdk-react
v3.0.0 - v3.1.0v1.xv1.0.0 - v1.0.1v1.10v7.0 - v7.2Initial 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.

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