v1.5.1

Changes

Full changelog: v1.5.0...v1.5.1

Bug Fixes

• Use Prompted SiteId in Generated Configuration Files #470 (Also removing api.config.js file)
• Fix proxy config for generated project #466
• Draft multi-site readme updates #457

v1.5.0

Full changelog: v1.4.0...v1.5.0

Base SDK

Featured Change: Enhanced Configuration Management

The base SDK now allows configurations based on your environments. For details, see the documentation on Configuration Files.

Related PRs: #421, #442, #451, #453

Bug Fixes

• Prevent accidental overwrite of default options in upload.js. #419
• Fix the versioning of the SDK's peer dependencies. #432
• Fix generator failing on Windows using WSL. #385

Other Changes

• Enhancements to project generator questions. #374
• Make enableBodyParser flag in createApp optional. #446
• Remove unused packages (url-parse and enzyme-adapter-react-16 ). #411, #424

Retail React App

Featured Change: Multi-Site Management

With v1.5, PWA Kit includes a reference implementation of multi-site management. For details, see the Multiple Sites guide in our documentation.

Related PRs: #391, #382, #452, #438, #445

Bug Fixes

• Fix for locale selector on Windows. #381
• Clean up the test mock server. #439, #441
• Add a fallback currency to the <ProductTile /> component. #450
• Warn when using incompatible versions of Node. #384, #410
• Fix the proxy config for a generated project. #454

Other Changes

• Support storing authentication tokens in a cookie to enable hybrid storefronts with user flows between SFRA and PWA Kit. #429

Community Contributions

@stm-dschulz made their first contribution by adding a forgot password flow to the Retail React App 🎉. #373

v1.4.0

Featured Change: Project Creation Presets

You can now create a PWA Kit project using presets. Presets let you specify a template for your project files and (optionally) use preconfigured settings for connecting to a B2C Commerce instance.

To create a project using the Retail React App template and connect it to our demo sandbox, run the following command in your terminal:

npx pwa-kit-create-app --preset retail-react-app-demo

With this new demo preset, anyone can try out PWA Kit in minutes!

To create a project with a different preset or use custom settings for connecting to your own B2C Commerce instance, run npx pwa-kit-create-app and follow the prompts.

To learn about all the available options for creating a project, run npx pwa-kit-create-app --help.

PRs: #285, #325, #322, #357, #358, #361

Changes

Full changelog: v1.3.0...v1.4.0

Bug Fixes

• Add constants for <meta theme-color|apple-mobile-web-app-title>. #287
• Hide locale selector when there’s only a single locale. #262
• Add to Cart remains active unless the item is out of stock. #222
• Update error link. #303
• Deprecate create-hash-manifest script. #300
• Fix redirect after account creation. #360

Security Updates

• Don’t send the HSTS header in local development. #288
• [Snyk] Security upgrade shelljs from 0.8.4 to 0.8.5. #307
• [Snyk] Security upgrade nanoid from 3.1.30 to 3.1.31. #308
• [Snyk] Security upgrade cross-fetch from 3.1.4 to 3.1.5. #351

Other Changes

• Support for React 17. #278
• Support for NPM 7 & 8. #302
• Update dependencies. #347, #346, #317
• Reuse proxy connections in SDK. #306
• Fix server error handling for unrecoverable errors. #326
• Preliminary translations for the demo storefront. #324

v1.3.0

Changes

v1.2.0...v1.3.0

Bug Fixes

• Promotion codes appear in uppercase in order summary. #224
• Order summary prices on checkout page misaligned on mobile. #233
• Shipping method description overflows the price section. #232
• Stack trace data and SSR options are visible on error pages when viewing page source. #230 #249
• Incorrect prop warning for section subtitle. #282
• Incorrect repository URL in the NPM registry. #257

Security Updates

• Set common HTTP security headers in the Retail React App. #263
• Remove upgrade-insecure-requests for local development. #270

Other Changes

• Locale-based URLs. You can include the locale in the URL path or as a query parameter using the new configuration in pwa-kit-config.json. #228 #255
• All configuration options related to the Commerce API and the Einstein API that were previously in commerce-api.config.js and einstein-api.config.js are now in one file: api.config.js. #256
• The new DynamicImage can transform your images by mapping an array of widths to the corresponding sizes and srcSet attributes. This component also makes it easier to use the Dynamic Imaging Service. #186
• The query parameters mobify_server_only and mobify_pretty used for debugging are now called __server_only and __pretty_print. The old query parameters are deprecated but still work. #250
• New id and defaultMessage parameters to enable translation for the Retail React App. #195 #207 #239 #252 #260
• New example product scroller on the home page of the Retail React App. #218 #208 #216
• The outputDir option for the npx pwa-kit-create-app script defaults to pwa-kit-starter-project instead of generated-project. #268
• The Seo component now fetches the default site title from pages/constants.js. #279
• The createApp function takes a new option called enableLegacyRemoteProxying that defaults to true. When set to false, local development proxying is disabled when running remotely. In future, local development proxying will always be disabled when running remotely. #205
• More informative error output when the locale configured in PWA kit doesn’t match the one in Business Manager. #225
• Improvements to README.md and CONTRIBUTING.md files for the repository. #241 #251 #271 #281
• Error messages point to the latest documentation and help topics. #268
• New and updated tests for search pages. #245

v1.2.0

🥳 This release focuses on a number of updates for localization and improvements related to SEO, performance, and shopper experience.

Changes

Full changelog: v1.1.0...v1.2.0

Retail React App: Localization

You can now build translation bundles using npm run build-translations as well as associate locale selectors with preferred currencies. Configurations are enabled so that you can keep all localization-related configurations in one place. For more information about localization, see the Localization README.

• Use the preferred currency when switching locales. #105
• When adding a new locale, minimize configuring the locale selector UI by having a list of commonly-used locales #175
• Rename the extract-messages and compile-messages commands to extract-default-translations and compile-translations #160
• For search engine crawlers, add hreflang links to the current page's HTML #137
• Allow individual Commerce API calls to pass in a different locale/currency and override the global value. #177
• Enabling pseudo locale now affects only the loading of the translation messages. The rest of the app still knows about English and the other locales. #177
• Fix regression with loading the correct translation file #193
• Fix Missing Locale Param for Commerce API Calls #174

Retail React App: Performance & Usability

A new simplified homepage makes it easier to get started with developing your storefront. We also implemented a couple of other fixes for performance and usability.

• Simplified storefront homepage #201
• Add cache-control header to product details page #172

Retail React App: Shopper Experience

Improvements in Einstein recommendation and wishlists enhance the shopper experience for the storefront.

• Ensure cookieId value is sent always for Einstein recommendations #179
• Integrate wishlist with Einstein recommended products. #131
• Enable favorite icons on product tiles for guest users #173
• Fix: Enable adding wishlist items to the cart. #158
• Rename CartItemVariant to ItemVariantProvider to improve reuse. #155

Fixes and Security Updates

• Remove x-powered-by HTTP response header #165
• Upgrade chakra-ui/react to ^1.7.1 version. #204
• Upgrade copy-webpack-plugin to fix tar vulnerability #181
• Clear SLAS tokens when OID is changed, so that when you connect to the different sandbox the new tokens are used #178
• Security package updates

v1.1.0

This release focuses on minor fixes and enhancements around quantity picker components, developer experience, and localization.

Changes

Full changelog: v1.0.0...v1.1.0

New Components

The default quantity picker pattern for product detail pages and cart pages have a friendlier user experience.

• New Quantity Picker component. #102

Developer Experience Enhancements

Developers can see a helpful stack trace for non-production deployments and local development, shortening debugging time.

• Improve error page design #74
• Ensure generated projects ship with a working .gitignore file #95

Performance

Some expensive page renders are faster thanks to caching and CPU optimizations.

• Add default cache-control header to home page. #103
• New Lazy Load Popover component. #134

Localization

As part of our gradual translation of PWA Kit across supported languages, the cart and checkout pages are prepared to accept translated messages.

• Localize cart and checkout messages. #106

Bug Fixes

• Fix wishlist bugs and provide better hooks for wishlist features. #64
• Fix pseudo-localization command to use en-XB. #101
• Remove eslint rule which check for Salesforce copyright #104

Security Updates

• Update inquirer package. #121