18-Aug-2026 • 4A8572 • Table Of Contents In the Project Source Code In a Deployed Application In the Project Source Code If you have access to the source code, you can find the Intershop PWA version in the package.json file under the version property. The project's CHANGELOG.md can also help determine the Intershop PWA version

18-Aug-2026 • G48571 • The PWA can be monitored using Prometheus. Activating the feature Prometheus for the nginx or SSR container exposes metrics on port 9113 on the /metrics URL. The SSR container also offers the configuration parameter METRICS_DETAIL_LEVEL to control the granularity of collected metrics: Value DEFAULT :

18-Aug-2026 • 4E8570 • Table Of Contents Intershop Commerce Management (ICM) PWA - Server-Side Rendering (SSR) PWA - Nginx CSR Mode with nginx Browser Default Production Deployment Deployment Without Nginx Hiding the ICM Backend Stateless vs. Stateful Building Blocks Further References Intershop Commerce Management (ICM) The

18-Aug-2026 • 48569H • Table Of Contents Web App Manifest In order to be a Progressive Web Application, the Intershop PWA implements some advanced concepts matching those criteria. Web App Manifest The Web App Manifest enables the PWA to be installable on home screens of mobile devices. The application is easily accessible

18-Aug-2026 • 4856B8 • Table Of Contents Simple Browser-Side Rendering Browser-Side Rendering with On-Demand Server-Side Pre-Rendering (Angular SSR) Further References Simple Browser-Side Rendering Angular applications are built for a static deployment by default. When running npm run build in any shape or form, the build

18-Aug-2026 • 48P566 • Table Of Contents Introduction Versioning Scheme Breaking Changes Introduction The PWA versioning system follows semantic versioning principles to communicate the nature and scope of each release in a consistent and predictable way. Due to the full availability of the PWA source code in GitHub, PATCH

18-Aug-2026 • 485E67 • Table Of Contents Apple App Site Association Configuring the PWA to Serve the AASA File Further References The /.well-known/ directory is a standardized location defined by RFC 8615. It is used to host configuration files and metadata that allow external services (such as mobile app linking, authentication

18-Aug-2026 • 48L565 • Table Of Contents File Name Conventions General Folder Structure Extension Folder Structure Modules Extending Modules File Name Conventions In accordance with the Angular Style Guide and the Angular CLI convention of naming generated elements in the file system, all file and folder names should use a

18-Aug-2026 • T48564 • Table Of Contents SSO with Auth0 for PWA Business Cases Create New User User Forgot Password Further References Intershop Commerce Management supports logging in clients via SSO (see Concept - Single Sign-On (SSO)). The PWA uses the library angular-oauth2-oidc to support an easy configuration for providing

18-Aug-2026 • 48F563 • Table Of Contents Login Registration Token Lifetime Logout This document describes the main authentication mechanism if the ICM server is used as identity provider. If you need an introduction to this topic, read the Authentication Concept first. Login If the user wants to login by clicking a login link

18-Aug-2026 • 485X62 • Table Of Contents Architecture State Selectors Actions Reducers Effects Facades Context Facades File Structure Core Store Structure Naming Actions - Types Actions - Creators Reducer State Selectors Facades - Streams Facades - Action Dispatchers Entity State Adapter for Managing Record Collections: @ngrx/entity

18-Aug-2026 • X48561 • Table Of Contents JSDoc Tags Document Only When Needed! The JSDoc comment format is used for general information. Examples for the comment styling pattern can be found here: TypeDoc - DocComments. Use this format to describe components, modules, etc., but also methods, inputs, variables and so on. Example

18-Aug-2026 • 48N560 • To enable user tracking and setting it up with Google Tag Manager, the popular library Angulartics2 is used. Note The standard Intershop PWA Google Tag Manager integration is very basic and currently only supports the tracking of route changes. Please refer to the angulartics2 documentation for information

18-Aug-2026 • 4855D9 • Table Of Contents Switching On Mocking Supply Mocked Data Sometimes during development, it might be necessary to work with mocked data. This is especially necessary when developing new features in parallel where backend and frontend are involved. In the PWA, we supply a mocking mechanism so that the

18-Aug-2026 • L48556 • Table Of Contents Requirements Architectural Concept Configuration Intershop Commerce Management (ICM) Intershop Progressive Web App (PWA) Mapping Table PWA Adaptions Preparing the PWA for the Hybrid Approach with the Responsive Starter Store Development Environment Configuration of a Development Domain

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