Guidelines
12-Jul-2026 • 48410L • Table Of Contents Introduction Configuration Login Token Lifetime Logout Important To use the Co-Browse functionality ICM version 11.8.0 or above is needed. This document describes the authentication mechanism if the co-browse identity provider is used to enable an agent to log in on behalf of a user
Guidelines
12-Jul-2026 • 484Y09 • Table Of Contents Introduction UX Patterns Navigation Patterns Skip Links for Long Listings Form Patterns Focus Management on Validation Errors Avoid Disabled Buttons Password Autocomplete Component Behavior Links with Icons Do Not Require Underlines Popovers Open on Click Instead of Hover Summary Introduction
Guidelines
12-Jul-2026 • 4840V8 • Table Of Contents Zones Zone Stability Using Zone Stability Service Workers and SSR Pitfall: The Zone Must Become Stable Change detection is one of the core concepts of Angular. Component templates contain data bindings that embed data from the component class into the view. The change detection cycle
Concepts
12-Jul-2026 • 48407N • This concept introduces some decisions made from an architectural point of view. The Intershop Progressive Web App is a REST API based storefront client that works together with the Intershop Commerce Management server version 11 or 7.10. This means that the communication between the Angular based storefront
Guidelines
12-Jul-2026 • 484Y06 • Table Of Contents Code Integrity Dependencies Code Formatting Unit Testing UI Testing Lighthouse Testing Performance Checks Accessibility Checks Testing Server-Side Rendering Static Code Analysis This section provides an overview of required continuous integration steps to verify the validity of code
Concepts
12-Jul-2026 • 4Q8405 • 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
Concepts
12-Jul-2026 • 48404H • 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
Concepts
12-Jul-2026 • 48C403 • Table Of Contents Simple Browser-Side Rendering Browser-Side Rendering with On-Demand Server-Side Pre-Rendering (Angular SSR) Impact of Service Workers Further References Simple Browser-Side Rendering Angular applications are built for a static deployment by default. When running npm run build in any
Guidelines
12-Jul-2026 • 484V02 • 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
Guidelines
12-Jul-2026 • 48401L • Table Of Contents Syntax Examples One Domain, One Channel, Multiple Locales Multiple Domains, Multiple Channels, Multiple Locales Multiple Subdomains, Multiple Channels, Multiple Locales Extended Example with Many Different Configurations Extended Example with Two Domains, One with Basic Auth (Except
Guidelines
12-Jul-2026 • 4840N0 • 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
Concepts
12-Jul-2026 • H48399 • Table Of Contents Motivation Configuration Multi-Site Production Deployment Further References Motivation Imagine running an Europe-wide shop with Intershop, where the website is available in 16 different countries with different languages and a varying selection of products, but only little modification
Guidelines
10-Jul-2026 • 48398C • 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
Concepts
10-Jul-2026 • 483C97 • 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
Guidelines
10-Jul-2026 • 483R96 • 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
Concepts
10-Jul-2026 • 48S395 • 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
Guidelines
10-Jul-2026 • K48394 • 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 Import Changes from New PWA Release (Migration) 1. Range Cherry Pick of New
Guidelines
10-Jul-2026 • 483D93 • 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
Guidelines
10-Jul-2026 • 48N392 • 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
Guidelines
10-Jul-2026 • 48G391 • 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