Guidelines
23-May-2026 • 482N67 • Table Of Contents Building Building Multiple Themes Running Development Local ICM Cache Heap Dumps Creation Analysis Further References Building To simply build the Intershop PWA in server-side rendering mode, you can use the package.json script npm run build , which builds the Intershop PWA with the
Concepts
23-May-2026 • 4826R6 • Table Of Contents Different Levels of Testing Unit Module Integration End-to-End Test File Locations Deviation from Standard Angular Test Frameworks PageObject Pattern Handling Test Data Further Help Different Levels of Testing Testing the PWA follows the basic principle of the test pyramid (https://martinfowler
Guidelines
23-May-2026 • 4826U5 • Table Of Contents Understanding PCI DSS 4.0 Applicability Secure Angular PWA Code & Dependencies Prevent Cross-Site Scripting (XSS) Attacks Secure API Calls & Prevent CORS Attacks Use Secure HTTP Headers to Prevent Browser Attacks Enforce Secure Authentication & Session Management Secure Server-Side
Guidelines
23-May-2026 • 4H8263 • Table Of Contents Overview Formly-Form Component FormlyFieldConfig Customizing Form Logic Custom Field Types Custom Wrappers Custom Extensions Validation Extras Formly Config Service Testing Formly Testing Custom Types Testing Wrappers Configuring Formly Intershop's Custom Formly Parts Field Types Wrappers
Guidelines
23-May-2026 • 4826N4 • Table Of Contents Configuration Additional chatflowConfig Variables Customize Chatbot Override Chatbot Styling handleToolCall Actions The Intershop PWA provides an integration with Intershop Copilot for Buyers. Official Intershop Documentation: Overview - Intershop Copilot for Buyers The Intershop Copilot
Guidelines
23-May-2026 • 482D62 • Table Of Contents Overview Prerequisites Version Dependency for PayPal Architecture Key Building Blocks Adapter Types Buttons Messages CardFields GooglePay Google Pay Payment Flow Google Pay Production Checklist ApplePay Apple Pay Payment Flow Domain Verification Page Types Styling Customization Pay
Guidelines
23-May-2026 • 482P61 • Table Of Contents Configuring ESLint Custom ESLint Rules Further Reading 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 eslint.config
Guidelines
23-May-2026 • 48260G • Table Of Contents Multiple Themes Developing the PWA with Several Themes Configurable Theme ICM Requirements Configuration Parameters Configuration JSON Developing with the Configurable Theme Multiple Themes It is possible to create multiple themes for the PWA, and the Intershop Progressive Web App currently
Guidelines
23-May-2026 • 4825Y9 • 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
Guidelines
23-May-2026 • 482M58 • 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
Guidelines
23-May-2026 • 48R257 • 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
23-May-2026 • 482H56 • Table Of Contents Introduction Angular CMS Components Navigation Components Account Content Pages View Contexts View Context Requests with Resource Set ID Design View Integration with an External CMS Introduction The Intershop REST API contains resources reflecting the aspects of Intershop's integrated
Concepts
23-May-2026 • 48255E • 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
23-May-2026 • 482N54 • 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
Guidelines
23-May-2026 • 48D253 • 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
Guidelines
23-May-2026 • 48R252 • 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
Guidelines
23-May-2026 • 4E8251 • 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
Guidelines
23-May-2026 • 482S50 • 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
23-May-2026 • 48X249 • 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
Concepts
23-May-2026 • 48248F • 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