References
10-Aug-2026 • 48512Z • 1. Scope & Audience Applies to every cartridge. Ignore generated/build output (bin/ , build/ , target/ ). Focus only on source (src/main/** , staticfiles/** , legacy resources) and Gradle build scripts. 2. Target Post-Migration Structure (per cartridge) <cartridge>/ build.gradle.kts staticfiles/cartridge/configdef/
References
10-Aug-2026 • 4851F1 • This document provides a comprehensive list of all ApplicationType component instances defined in the ICM workspace. REST API Instances The following table lists all REST related instances: ApplicationType Instance Cartridge Category Dependency (external) intershop.REST app_sf_headless Storefront cartridgeRuntime("com
Guidelines
10-Aug-2026 • 4A8510 • This document outlines the migration process from ICM 7.10 to ICM 11. It includes the automated steps performed by the migration tool, as well as the manual steps required afterward. Table of Contents Preparation Steps Prepare ICM 11 Template Verify ICM 11 Template Prepare ICM 11 Branch Automated Migration
Guidelines
10-Aug-2026 • 4850G9 • This document outlines the migration process from ICM 11 to ICM 12. It includes the automated steps performed by the migration tool, as well as the manual steps required afterward. Table of Contents Preparation Steps Prepare ICM 12 Branch Automated Migration Steps Integrate OpenRewrite recipes Manual
Guidelines
10-Aug-2026 • 485Y08 • This document outlines the migration process from ICM 12 to ICM 13. It covers the automated processes handled by the migration tool, as well as the manual interventions necessary to complete the upgrade. Table of Contents Preparation Steps Prepare ICM 13 Branch Automated Migration Steps Integrate OpenRewrite
Overviews
10-Aug-2026 • 48507E • This projects contains three major tools to support migration projects from ICM7.10 to ICM11+. The "migration tool" uses standard Java Application to migrate up to the latest version. Major tasks are exposed via gradle. The "AI migration tools" to instruct Github Copilot (in agent mode) to help migrate
Guidelines
10-Aug-2026 • 48B506 • 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
Guidelines
10-Aug-2026 • 48505Y • Table Of Contents Angular CLI Environment Files URL Parameters Runtime Environment Properties Further References This guide describes how to propagate additional configuration from the outside into the PWA client application to be used on the storefront. Configuration parameters can be provided from
Concepts
10-Aug-2026 • 485Z03 • 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 SSR for pre-rendering complete pages to tackle SEO concerns. An Angular application
Guidelines
10-Aug-2026 • 485H04 • Table Of Contents Component Declaration in the Right NgModule No Use of NgRx or Services in Components Delegation of Complex Component Logic to Services Minimal Logic in Constructor Property Binding for Dynamic Values No Manual Unsubscribing No Duplicate Subscriptions in Templates Flattening Nested @if
Guidelines
10-Aug-2026 • 48502H • 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
Guidelines
10-Aug-2026 • A48501 • 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
10-Aug-2026 • 48500A • 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
Guidelines
10-Aug-2026 • T48499 • Table Of Contents Introduction Development Accessibility Checklist Common Keyboard Visual Requirements Proper Semantics Images Forms Project Accessibility Checklist Introduction The accessibility checklist is designed to assist developers, visual and interaction designers, requirements engineers, and
Guidelines
10-Aug-2026 • 4849Q8 • 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
10-Aug-2026 • 48F497 • 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
Concepts
10-Aug-2026 • 48T495 • 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
10-Aug-2026 • 48496S • 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
10-Aug-2026 • 48E494 • Table Of Contents Introduction Configuration Storefront Further References Introduction In the PWA registered users can subscribe to and unsubscribe from a newsletter service. Configuration To enable this feature, an e-mail marketing provider has to be configured in Intershop Commerce Management under
Guidelines
10-Aug-2026 • 4849K3 • 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