18-Aug-2026 • 485Z55 • Table Of Contents Preparation Choose an Import Approach Rebase Commits of New Release Range Cherry Pick of New Release Commits Merge the New Release in its Entirety After Importing the Changes Install Dependencies Run the Provided Migration Schematics Verify the Project Further References Integrating

18-Aug-2026 • 4R8554 • Table Of Contents NgRx Pitfalls Using Services and catchError Using switchMap can Lead to Race Conditions Should I put XYZ into the Store or the Component? Testing NgRx Artifacts Using the State Management in Tests Reducers and Actions Selectors Effects NgRx Pitfalls Using Services and catchError The

18-Aug-2026 • G48553 • Table Of Contents Introduction Library angular-oauth2-oidc Implementation and Configuration of Identity Providers PWA Initialization Login, Registration, Token Refreshment, Logout Vanishing of the apiToken Cookie Further References Introduction Several ICM REST operations require an authenticated user

18-Aug-2026 • 4855C2 • Table Of Contents When to Write Cypress Tests? Rules for Developing Cypress Tests Always Stick to Small Scope Pay Respect to Individuality Do not Reinvent the Wheel Stick to the PageObject Pattern Debugging Flaky Cypress Tests Further References When to Write Cypress Tests? With Angular most of the functionality

18-Aug-2026 • 4855U1 • Table Of Contents Rewriting Concept Rewriting Artifacts matchXRoute XRoutePipe ofXRoute (optional) Further References The PWA allows to supply localized and SEO optimized URLs for categories and product detail pages. Rewriting Concept This feature is mainly built on top of Angular's UrlMatcher for parsing

18-Aug-2026 • 48550D • Table Of Contents Ways of Configuring Angular Applications Angular CLI Environments Node.js Environment Variables NgRx Configuration State URL Parameters Different Levels of Configuration Settings Build Settings Deployment Settings Runtime Settings Configurations REST Resource ICM Endpoint Configuration

18-Aug-2026 • 4854T9 • Table Of Contents Quick Start Step 1 - Clone the Project Step 2 - Install the Dependencies Step 3 - Start the Intershop PWA Customization Deployment Running Tests Code Style Type Safety Pre-Commit Check Code Scaffolding Further Help Quick Start Before working with this project, download and install Node

18-Aug-2026 • 4854V8 • Table Of Contents CMS Enhanced Image Teaser Further References With the growing importance of good Core Web Vitals (CWV) metrics, the Intershop PWA includes several optimizations and functionalities that are intended to improve these metrics. The following chapter lists aspects of the Intershop PWA that

18-Aug-2026 • 485B47 • Table Of Contents What is a Product Context? How to Introduce Product Context? By Using ProductContextDirective By Providing ProductContextFacade By Providing SelectedProductContextFacade Retrieving Data from the Product Context Inject ProductContextFacade Use ProductContextAccessDirective Linking Embedded

18-Aug-2026 • 4Z8546 • Table Of Contents Set up an Intershop PWA-based Project Start Customization Specific Concerns Components Theme-Specific Overrides Existing Features New Features Data NgRx Testing Styling Static Assets Dependencies Cypress Tests Hints Further References When customizing the PWA, always keep in mind that

18-Aug-2026 • T48545 • Table Of Contents Configure Cookie Consent Options Control Cookie Consent Banner Display Cookie Consent Settings Enable PWA Functionality Dependent on Cookie Consent Settings Displaying the Cookie Consent Options PWA Required Cookies Disabling the Integrated Cookie Consent Handling The Intershop PWA

18-Aug-2026 • 48544F • Table Of Contents Usage Examples Localization of Simple Text Localization with Parameters Localization with Pluralization Localization with Formatted Dates Localization of Text with HTML Tags Localization in the component(.ts) File Localization of Text with HTML-Anchors (Links) & OnClickHandlers (Callback-Functions)

18-Aug-2026 • 4854C3 • Table Of Contents Setup Workflow Further References We integrated Address Doctor to verify address data for correctness. The current integration is based on the Address Doctor API 6.0.0. Setup First, activate the feature toggle addressDoctor . You will also have to provide the endpoint and additional

18-Aug-2026 • 4854B2 • Table Of Contents Introduction Workflow Check the Accessibility of a Page ESLint Rules Partially Automated Testing Google Lighthouse Silktide - Accessibility Checker WAVE - Web Accessibility Evaluation Tool IBM - Equal Access Accessibility Checker Manual Testing Keyboard Screen Reader Further References

18-Aug-2026 • 4854Y1 • Table Of Contents Building Configuration HTTPS or SSL Basic Auth Multi-Site Ignore Parameters During Caching Access ICM Sitemap Override Identity Providers by Path Add Additional Headers Content Security Policy Other Features Cache Cache Clearing Shared Redis Cache Cache Timing Clearing the Redis Cache

18-Aug-2026 • 4853V9 • NGINX Optimizations NGINX Optimizations Custom Webpack Build PurgeCSS Safelisting Development Further References The NGINX building block applies: Compression of responses ngx_brotli is used to compress files on NGINX because Brotli has a better compression ratio compared to gzip. The configuration of

18-Aug-2026 • 48540N • To enable Store Locator, add storeLocator to the feature list in your environment file. This will enable a page where users can search for stores based on a country, city and/or postal code. Google Maps Integration Store Locator provides an optional Google Maps integration using the Google Maps JavaScript

18-Aug-2026 • 4853V8 • Table Of Contents Overview The Field Library Retrieving Configurations Retrieving Configuration Groups Defining Your Own Configurations & Configuration Groups Defining a FieldLibraryConfiguration Defining a FieldLibraryConfigurationGroup Automatic Field Replacement Using the '#' Pseudo-Type Address Forms

18-Aug-2026 • 4M8537 • Table Of Contents Stick to General Unit Testing Rules Single Responsibility Test Functionality - Not Implementation Do not Comment out Tests Always Test the Initial State of a Service/Component/Module/... Do not Test the Obvious Make Stronger Assertions Do not Meddle with the Framework Assure Readability

18-Aug-2026 • 4853P6 • Table Of Contents Built-in Angular CLI Support Setting Deploy URL Dynamically Problem Solution Building with Dynamic Deploy URL Scenarios CDN Support Embed PWA with Proxy on Website Serving the PWA from a Sub-Path Including Static Files Further References This document describes how to provide the Intershop