28-Mar-2025 • 30A835 • 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

16-Sep-2025 • 3R0834 • Table Of Contents Introduction Angular CMS Components Navigation Components Account Content Pages View Contexts Design View Integration with an External CMS Introduction The Intershop REST API contains resources reflecting the aspects of Intershop's integrated Content Management System (CMS), i.e., Pagelets

28-Mar-2025 • B30833 • 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

28-Mar-2025 • H30832 • Table Of Contents Server Side Rendering robots.txt Page Metadata Optimized URLs This concept documents our approach for search engine optimization for the Intershop Progressive Web App. Server Side Rendering The PWA uses Universal for pre-rendering complete pages to tackle SEO concerns. An Angular application

28-Mar-2025 • 3Z0831 • Table Of Contents Code Integrity Dependencies Code Formatting Unit Testing UI Testing Lighthouse Testing Performance Checks Accessibility Checks Universal Testing Static Code Analysis This section provides an overview of required continuous integration steps to verify the validity of code contributions

28-Mar-2025 • 308E30 • 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

28-Mar-2025 • 30X829 • Table Of Contents Configuring ESLint Custom ESLint Rules The PWA uses ESLint for static code analysis and to enforce best practices. In order to use ESLint with Angular, we use the typescript-eslint and angular-eslint packages extensively. The PWA's ruleset is configured in .eslintrc.json and includes

28-Mar-2025 • 308C28 • Table Of Contents Configuration Login Registration Token Lifetime Logout This document describes the authentication mechanism if punchout is used as identity provider. If you need an introduction to this topic, read the Authentication Concept first. Configuration The PWA must be configured in a specific

28-Mar-2025 • T30827 • 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

05-Nov-2025 • 3082L6 • Table Of Contents Bootstrap Integration Assets Fonts Icons Optimization References The visual design (styling) and the interaction design (behavior) of the Intershop Progressive Web App is derived from the Responsive Starter Store with some changes (e.g., the header) to improve and modernize the customer

05-Nov-2025 • 3E0825 • Developers Getting Started Architecture Concept - Software Architecture Concept - Project Structure Concept - State Management Guide - State Management Guide - Product Context Concept - CMS Integration Concept - Configuration Guide - Propagating Environment Variables Concept - Localization Concept -

28-Mar-2025 • 3C0823 • 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

28-Mar-2025 • 3L0822 • 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

28-Mar-2025 • 3A0821 • Table Of Contents Mapping Incoming Rewritten ICM URLs to the PWA Mapping PWA URLs to Rewritten ICM URLs Further References If the ICM is set up with URL Rewriting, further modifications are required to run the deployment with the Hybrid Approach. The examples in this guide follow the default example

28-Mar-2025 • V30820 • Table Of Contents Web App Manifest Service Worker 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

21-Dec-2023 • 30D819 • The data models for server-side and client-side have to be separated, because the data sent by the server may change over iterations or may not be in the right format, while the client side shop data handling should be stable for a long time. Therefore, each service communicating with the Intershop REST

28-Mar-2025 • 308V18 • Table Of Contents Server-Side Rendering (SSR) NGINX Logging to an External Device PWA (SSR with PM2) NGINX Further References Server-Side Rendering (SSR) The express.js image serving the Angular Universal Server-Side Rendering can be provisioned to log extended information to the console by supplying

28-Mar-2025 • 30817Y • 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

20-Mar-2024 • 30815Y • 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

28-Nov-2025 • N30806 • Introduction Recipe: Configure the Order Export for the BI Data Hub Recipe: Add BI Dashboard to ICM Recipe: Create Report Based on Intershop Template Recipe: Adjust Reports Recipe: Download Default Report Templates from Intershop Recipe: Use BI Data Hub Data in Microsoft Fabric Introduction The BI Data