Release Information for All Versions of Composable Storefront Libraries
Introduction
This document describes what is included in all composable storefront libraries since the initial 1.0 release.
-
For information about which versions of the composable storefront libraries and SAP Commerce Cloud are required for a specific feature, see the Feature Compatibility Matrix.
-
If you have technical or how-to questions about using composable storefront, try asking on Stack Overflow
. -
If you would like to report an issue for assistance from SAP, please use the SAP Launchpad reporting tool

Release 5.2 (February 2023)
Release 5.2 libraries published February 17, 2023
Highlights include the following:
-
Customer Service and Ticketing
-
B2B Reorder
-
New Mobile Phone Number in Shipping Address Form
-
Improvements to Configurable Products: Show Prices for Options; Display Delta Prices
Release 5.1 (January 2023)
Release 5.1 libraries published January 18, 2023
Highlights include the following:
-
Support for multi-site isolation
-
B2B Unit-Level Order View
-
B2B Payment Controls
-
B2B Account Summary for Commerce Organization
-
B2B Checkout and ASM fix (due to cost center)
-
Estimated delivery schedules for the items in cart for S/4HANA based Order Management
-
B2B Registration
-
B2B Order Listings: purchase order and cost center display
-
ASM Anonymous Cart Binding
-
ASM Customer List
-
New events: add cart voucher, remove cart voucher
Release 5.0 (November 2022)
Release 5.0 libraries published November 23, 2022
Highlights include the following:
-
Composable storefront (project "Spartacus") libraries are now published to the Repo-Based Shipment Channel for SAP Commerce Cloud customers. Libraries are no longer published to npmjs.com.
-
Angular framework updated to Angular 14.
-
More cart functionality, such as base cart and wish list, moved to the cart library.
-
Commands and queries have been implemented in the checkout library.
-
Screen readers and other accessibility improvements have been added.
-
Support has been added for PDF and video components that were introduced in version 2205 of SAP Commerce Cloud.
-
The following user experience improvements were added: add to cart from saved cart, clear cart, scroll to top button, show password in password form field, add to cart from carousel.
-
The following Configurable Products Integration improvements were added: retract User Selections and numeric attributes with interval domain.
Release 4.3 (January 2022)
Release 4.3 libraries published January 21, 2022
Highlights include the following:
DEPRECATED - SAP Enterprise Product Development Visualization Integration
The SAP Enterprise Product Development Visualization Integration provides support for visual picking of spare parts using 2D or 3D models of the relevant products. For more information, see SAP Enterprise Product Development Visualization Integration.
Release 4.2 (November 2021)
Release 4.2 libraries published November 10, 2021
Highlights include the following:
Import Products to Active or Saved Cart
This feature allows customers to use a comma-separated values (CSV) file to quickly import multiple products to the active cart or into a saved cart. The CSV file contains the product SKU and quantity. For more information, see Cart Import and Export.
Export Products From Active or Saved Cart
This feature allows customers to export an active or saved cart to a CSV file. By default, the exported file contains the product SKU, quantity, name, and price, but this is configurable. For more information, see Cart Import and Export.
Product Image Zoom
This feature allows customers to magnify product images when viewed from the Product Details page. Clicking a product image enters "zoom mode", at which point the customer can magnify the picture based on mouse location. For more information, see Image Zoom.
Quick Order Improvement: Search by Product Name
The Quick Order feature was introduced in the 4.1 composable storefront libraries. With this improvement, customers using the form are now able to search by product name, not just SKU. The Quick Order field on the cart page is not affected. For more information, see Quick Order.
Cart Validation
This feature identifies issues with customer cart when opening the Cart page or when proceeding to check out, and is extensible. The typical use case is when a customer adds a product to the cart today, and then tomorrow goes to check out, but there is no more stock. In this example, a message is displayed to the customer about what happened, and the product is removed from the cart. For more information, see Cart Validation.
Scroll Position Restoration
This improvement maintains the scroll position when moving forward and backward throughout a composable storefront-based site. The user experience is greatly improved when searching or viewing categories, reviewing product information, and going back. For more information, see Scroll Position Restoration.
Order History Library
The introduction of a separate library for order history functionality is part of a long-term performance improvement effort. By separating the codebase into smaller libraries, packages are smaller, allowing for better lazy loading and improved performance. For example, with the Order History library, the code is only loaded when customers want to view orders they have already submitted. The existing Order History code is deprecated and will be removed in a future major release. Note that when upgrading, the existing Order History code is used, but when installing from schematics, the new library is used. For more information, see the Order Library Release Notes
.
Improvements Related to Support for Screen Readers
If you dive into the source code, you may notice improvements in various places related to support for screen readers. This effort is not complete. We are planning to announce support for screen readers in the next major, 5.0, for most core features.
Release 4.1 (September 2021)
Release 4.1 libraries published September 14, 2021
Highlights include the following:
SAP Digital Payments Integration
SAP Digital Payments integration is an out-of-the-box alternative to current custom payment service provider (PSP) integrations. This integration uses SAP Digital Payments with ready-to-use PSP connectivity. For more information, see SAP Digital Payments Integration.
Quick Order
The Quick Order feature allows users to quickly add multiple items to their cart. There is also the option to quickly add a single product from the cart page. For more information, see Quick Order.
B2B Inventory Display
The B2B Inventory Display feature allows sellers to control the display of the stock visible for a category of products or for the whole storefront. Composable storefront now supports display of actual stock values, so when this feature is enabled in the back end, the page displays "## in stock". When the feature is disabled, customers see “In Stock” or “Out of Stock”, as in previous versions of composable storefront. For more information, see Inventory Display, as well as B2B Inventory Display.
Authentication Improvements
Several improvements were made to authentication that help make authentication expiry during checkout more reliable. These fixes were backported to 3.0 through to 3.4, as well as to 4.0.
SSR maxRenderTime Option
The maxRenderTime setting is the maximum amount of time expected for a render to complete. If the render exceeds this timeout, the concurrency slot is released, which allows the next request to be server-side rendered. For more information, see Configuring the SSR Optimization Engine.
Release 4.0 (July 2021)
Release 4.0 libraries published July 29, 2021
As with every new major release, 4.0 contains breaking changes. Make sure to read the Development Release Notes
and the Technical Changes in Spartacus 4.0
migration guide.
Highlights include the following:
Angular 12
With every new major, we upgrade Angular in order to be able to use new features and of course take advantage of security improvements and bug fixes. For a quick summary of what's new, see the Angular blog post, Angular v12 is now available
.
CPQ Configurable Products Integration: Display of Prices for Attribute Values
The display of prices for individual options or attribute values is now supported, not only for bundle items (attributes linked to products), but also for simple attribute values (non-bundle items). For more information, see SAP CPQ Configurable Products Integration.
Cleanup and removal of deprecated code
Removal of deprecated code is performed with every major release. Migration information is documented in the Updating to Version 4.0
migration guide.
Checkout moved to a library
The move of checkout to its own library continues our process of breaking the big composable storefront core library into smaller libraries, which will allow composable storefront to become smaller in the browser, more modular, and will also allow customers to only import what they need when they need it.
Cloning option when restoring saved cart
When restoring a saved cart, the option to keep a copy of the cart is now available. For more information, see Saved Cart.
Additionally...
This release also includes partial but incomplete support for the following (see roadmap for completion dates):
-
screen readers
-
the new "blue" Santorini storefront theme. For more information, see Storefront Themes.
Release 3.4 (June 2021)
Release 3.4 libraries published June 16, 2021
Cart API refactoring
The Cart API was refactored to make development easier. For example, many classes were made protected and thus more extensible. (See here
for more information.) Inline documentation was also improved.
Code splitting for performance improvement
Code splitting continues with new libraries for more modules, such as Intelligent Selling Services, Store Finder, Account, Profile, and ASM. For installation information, see Schematics.
Simplified schematics installation
Installation selection when adding features using ng add @spartacus/schematics@ was simplified. A single list is presented at the start, and dependencies or sub-coponents automatically determined by feature. The list of modules reflects the changes due to the code splitting initative.
New events
New events were added: Cart Remove Entry Success, Cart Remove Entry Fail, Cart Update Entry Fail (see GitHub issue 12125
). For more information, see Event Service.
Release 3.3 (May 2021)
Release 3.3 libraries published May 12, 2021
SAP CPQ Integration for Configurable Products
-
Bundling and guided-selling scenarios where the bundle in Commerce contains simple (non-configurable) products. The dependencies within this bundle are controlled by the underlying CPQ configurable product
-
Single-level configurable products in your Commerce composable storefront where the product model resides in SAP CPQ
-
Configuration page with the most commonly used attribute types, especially attributes with values that are linked to a (non-configurable) product. Attribute types with quantity on attribute or attribute value level are supported
-
Price summary at the bottom of the configuration page with the base price, the price of the selected options, and the overall total price of the configured product
-
Overview page with all user selections accessible at any time during configuration
-
Configurable bundles are part of storefront processes such as catalog browsing, product detail page, add to cart, checkout, and order history
-
For underlying functionality in detail and for features that are currently not supported, see SAP CPQ Configurable Products Integration.
Release 3.2 (April 2021)
Release 3.2 libraries published April 15, 2021
Schematics Behavior Updated
The default behavior for schematics has been changed and composable storefront is now installed with a new app structure. For more information, see Reference App Structure.
Tag Manager framework
Documentation: Tag Management System
New Tag Manager framework with support for Google and Adobe tag systems, and Google Analytics
New events for Event Service
Documentation: Event Service
-
Search suggestion clicked
-
Facet changed in search/category results
-
Context change (language/currency)
B2B Bulk Pricing
Documentation: Bulk Pricing
Saved Carts
Documentation: Saved Cart
New popover text component
Documentation: Popover Component
HTML tags
Documentation: HTML Tags
General improvements to B2B Commerce Organization user experience
Code splitting for performance improvements
Code splitting continues with new libraries for SmartEdit, Events, Tag Management, and saved carts. For installation information, see Schematics.
New module initialization functionality for lazy-loaded features
See Initializing Lazy Loaded Modules in Lazy Loading of Modules.
SAP Customer Data Cloud
Documentation: SAP Customer Data Cloud Integration
Official release of the SAP Customer Data Cloud integration library.
Dynamic configuration with support for site themes
Documentation: Theme Configuration
Bug fixes
Updates to documentation
Updates to documentation have been published for all topics, with additional updates to:
Release 3.1 (February 2021)
Release 3.1 libraries published February 25, 2021
-
SAP Variant Configuration and Pricing
-
Qualtrics Embedded Feedback
-
New Events
-
Performance Improvements with Code Splitting
SAP Variant Configuration and Pricing
We're happy to announce that the composable storefront library for SAP Variant Configuration and Pricing has been released. This library provides the following features:
-
Single-level and multilevel configurable products in your composable storefront, where the product model resides in SAP ERP or SAP S/4HANA
-
A configuration page with the most commonly used characteristic types, such as radio buttons, checkboxes, drop-down listboxes, and images for characteristic values
-
A price summary at the bottom of the configuration page with the base price, the price of the selected options, and the total price of the configured product
-
An overview page with all user selections accessible at any time during configuration
-
Basic conflict handling
-
Inclusion of configurable products as part of storefront processes, such as catalog browsing, product detail page, add to cart, checkout, and order history
The SAP Variant Configuration and Pricing add-on for Commerce provides the user interface (UI) with which configurable products can be configured and sold using SAP Variant Configuration and Pricing.
For more information, see Configurable Products Integration in the composable storefront documentation, and [Product Configuration with SAP Variant Configuration and Pricing](https://help.sap.com/viewer/80c3212d1d4646c5b91db43b84e9db47/latest/en-US) on the SAP Help Portal.
Qualtrics Embedded Feedback
We're happy to also announce support for the Qualtrics Embedded Feedback feature. For more information, see Composable Storefront Support for Qualtrics Embedded Feedback.
ngadd@spartacus/qualtrics
New Events
Events now triggered when a customer logs in or logs out. For more information, see Event Service.
Performance Improvements with Code Splitting / Lazy Loading
The composable storefront code-based is being separated out into modules for better performance. The 3.1 release includes new libraries for Qualtrics and Variant Configuration. More modules will be split out in future releases. For more information, see Lazy-Loaded CMS Components in Configuring Custom Components.
Release 3.0 (December 2020)
Release 3.0 libraries published December 17, 2020
-
Uses Angular 10
-
B2B Powertools Store support (for more information, see powertoolsstore Extension)
-
B2B Commerce Organization (Composable storefront-specific documentation to come - for information on the overall feature as provided by SAP Commerce Cloud, see Commerce Organization)
-
B2B Checkout (documentation: B2B Checkout). For information on the overall feature as provided by SAP Commerce Cloud, see [B2B Checkout](https://help.sap.com/viewer/4c33bf189ab9409e84e589295c36d96e/latest/en-US/8ac2500f8669101493e69e1392b970fd.html) in the SAP Help Portal.
-
B2B Scheduled Replenishment (documentation: Scheduled Replenishment
-
Session Management (documentation: Session Management
-
Release 3.0 Documentation published (v2 and v1 archived)
As always, feedback appreciated! Contact us through Slack or submit an issue
.
Notes about this Release
-
Make sure to use the latest sample data, which includes updates to CMS data for the out-of-the-box Powertools store.
-
Composable storefront 3.0 and later use the new composable storefront sample data extension (not the addon). For now we provide both for download. However, the sample data extension will be the only one updated in the future.
-
The same backend can be used for hosting both B2C and B2B stores. However, composable storefront requires two different apps, with two different configurations, one for B2C stores, and one for B2B stores. (The ability to use one app for both B2C and B2B will be added in a future composable storefront release.) For more information, see Building the Composable Storefront From 5.2 Libraries.
-
Setting up a B2B composable storefront store follows the same process as for a B2C store, with one extra step for adding B2B Commerce Organization features using schematics (ng add @spartacus/organization). For more information, see Building the Composable Storefront From 5.2 Libraries.
-
Do not use a B2B composable storefront for a B2C base store. OCC API calls are different, and many aspects of the store will not work. For example, if you point a B2B store to Electronics base store, adding to cart does not work as the call is different.
-
B2B Commerce Organization allows you to configure units, users, budgets, cost centers, and spending limits, for the purposes of spend tracking and requiring approvals. For more information on how this feature works in SAP Commerce Cloud, see Commerce Organization.
-
SAP Commerce Cloud ships with all users disabled and no passwords defined. When exploring how to use composable storefront and SAP Commerce Cloud, one of the steps is to import sample users and passwords (see Setting Passwords for Default Users). After that is done, you can use the default B2B users as defined in the powertoolsstore Extension. For example, you can log in as linda.wolf@rustic-hw.com, who is an administrator for the Rustic Hardware set of units.
Release 2.1 (August 2020)
Release 2.1.0 libraries published August 27, 2020
-
Directionality: Provides support for bidirectional text and layout. You can configure composable storefront to use a left-to-right (LTR) orientation, or a right-to-left (RTL) orientation. The 2.1 feature is for core functionality; that composable storefront updates to CSS will be completed in the 3.0. For more information, see the Directionality.
-
Style Library Versioning: Allows the core composable storefront development team to introduce gradual changes in the style layer while maintaining backwards compatibility. New or adjusted style rules are added for a specific version, but these changes are not added in the style build process unless you explicitly opt in to receive these changes. For more information, see the CSS Architecture.
Release 2.0 (June 2020)
Release 2.0.0 libraries published June 3, 2020
As Release 2.0 is a new major version, it contains breaking changes. To migrate to 2.0 from 1.x, see the following documentation:
-
Updating to Version 2.0
(automated update using schematics)
The following is a summary of the major changes introduced in 2.0:
-
Framework updated to Angular 9, including related dependencies such as ngrx 9
-
Updates to Schematics
-
Accessibility Keyboarding features: Keyboard Focus
-
Event Service, with Add to Cart event
-
Custom Angular URL Matching: Avoiding Static URL Segments in the Product Page URL (Advanced)
-
Many components refactored
-
New facet navigation makes extending facets easier
-
Deprecated code removed
Notes for deployment of composable storefront 2.0 storefronts via SAP Commerce cloud hosting service
Composable storefront 2.0 uses Angular 9, which changes certain file locations. As of this writing (July 2020), to use composable storefront 2.0 with SAP Commerce Cloud in the Public Cloud hosting services, you must make the following changes to your Angular application for it to build properly. (For more information, see https://github.com/SAP/spartacus/issues/7993.) This will be fixed in a future release of SAP Commerce Cloud in the Public Cloud.
Changes in angular.json:
-
"outputPath": "dist/app-name/browser" to
"outputPath": "dist/app-name"
-
"outputPath": "dist/app-name/server" to
"outputPath": "dist/app-name-server"
Change in server.ts:
-
const distFolder = join(process.cwd(), 'dist/app-name/browser'); to
const distFolder = join(process.cwd(), 'dist/app-name');
For more information on changes
For a detailed list of all changes for 2.0 and previous 'next' releases of the composable storefront libraries, see theSpartacus project release page
on GitHub.
Release 1.5 (February 2020)
Release 1.5 libraries published February 26, 2020
Intelligent Selling Services for SAP Commerce Cloud provides real-time customer experience personalization for SAP Commerce Cloud, now with support for Spartacus! Integration includes the Profile Tag and the Merchandising Carousel features. For more information on the Intelligent Selling Services feature itself, see Intelligent Selling Services for SAP Commerce Cloud.
Increase conversion and customer loyalty with Customer Coupons. This feature provides a range of functionality for promotion campaigns, such as allowing customers to claim a coupon using the coupon’s campaign URL, turning on status notifications for a coupon, allowing users to view their coupons in the My Coupons section, and applying usable coupons during checkout.
Increase conversion and buyer convenience with Selective Cart. Also known as "Save for Later", Selective Cart allows customers to select which items in the cart they wish to purchase, and to leave other items in the cart for future consideration. This improves the shopping experience and increases the conversion rate.
Organize and logically display product variants like color and size, making it easier for customers to discover the particular style they want.
-
Applied Promotions
Promotions now appear in all required locations (in the Added-to-Cart modal for example), not just in the cart. Per-product promotions now also appear in the product entry. This work also includes refactoring to accommodate future support for potential promotions.
The Skip Links features allows users to quickly navigate to important areas of a page using the keyboard. This feature is the first of several Accessibility feature improvements planned for composable storefront.
-
Bug fixes as described in the development release notes

Release 1.4 (January 2020)
Release 1.4 libraries published January 27, 2020
What's new?
-
Token Revocation (supports back end improvement added to 1905.6)
-
Product data performance improvements with Loading Scopes. You can also see GitHub Issue 3666
for more information. -
CMS component data loading optimization. For more information, see GitHub Issue 5845

-
Updates to cart handling to support future features. For more information, see GitHub Issue 4432

Release 1.3 (November 2019)
Release 1.3 libraries published November 18, 2019
Architecture and Development Features
-
Storefront Self-Configuration (detection of languages, currencies, and other site settings through base site API)
-
Structured Data (provides a data structure for the web that makes the web content more understandable for web crawlers)
-
Qualtrics intercept integration and example
Core/B2C Storefront Features
-
Assisted Service Module (ASM) customer emulation (requires October patch release of SAP Commerce Cloud 1905)
Composable storefront Documentation: Assisted Service Module SAP Commerce Cloud Documentation: Assisted Service Module
-
Anonymous consent
Composable storefront Documentation: Anonymous Consent SAP Commerce Cloud Documentation: Anonymous Consent Management
-
Coupons (requires October patch release of SAP Commerce Cloud 1905)
Composable storefront Documentation: Coupons SAP Commerce Cloud Documentation: Coupons in Accelerator
B2B Storefront Features
Powertools sample data modified to work with composable storefront (requires latest spartacussampledata).
Release 1.2 (September 2019)
Release 1.2 libraries published September 30, 2019
What's new?
-
Routing Migration
-
Angular updated to 8.2.5; NgRx to 8.3.0; other dependency updates
To update to 1.2.0, you must change your libraries in package.json and and dependencies inside app.module.ts. See Building the Composable Storefront From 5.2 Libraries for more information.
-
To use 1.2 features, add these to B2cStorefrontModule.withConfig({
features: {
level: '1.2',
consignmentTracking: true,
},
-
To enable guest or express checkout, add these to B2cStorefrontModule.withConfig({
checkout: {
express: true,
guest: true
},
-
To use infinite scroll, add these to B2cStorefrontModule.withConfig({
view: {
infiniteScroll: {
active: true,
productLimit: 500,
showMoreButton: false,
},
},
-
To see ‘early login’ in action, after this line:
ConfigModule.withConfigFactory(defaultCmsContentConfig)
add
ConfigModule.withConfig({routing: { protected: true, } })
-
To enable consignment tracking, add this to features:
features: {
consignmentTracking: true
}
Release 1.1 (August 2019)
Release 1.1 libraries published August 29, 2019
Release notes: https://github.com/SAP/spartacus/releases
-
Change to registration and login flow: must log in after registering

-
Also released: a beta of a new library, Schematics
. Schematics allow for easy setup of composable storefront libraries with a new Angular project in one command. In the future, schematics will help in upgrading, maintaining, customizing, and building projects with composable storefront libraries (for example: template generators for custom cms components). A detailed description about schematics can be found here
.
Release 1.0 (July 2019)
Release 1.0 libraries published July 4, 2019
Customer-facing storefront features:
| Page/Area | Notes |
|---|---|
|
Header |
Displays language and currency selection, shortcut links to help and other sample information pages, logo, search box, cart icon, category bar, and breadcrumbs |
|
Footer |
Displays company links and copyright notice |
|
Home |
Driven by CMS page layout and slots |
|
Search |
Search box in header displays search and product suggestions; search results include facets provided by backend |
|
Categories |
Category menus in header display up to 2 levels; category results include facets provided by backend |
|
Product details |
Displays product title, images, price, quantity selection, add to cart, stock, and summary; supplementary information area includes details, specifications, reviews, and shipping information |
|
Added-to-cart modal |
Displays confirmation that a product was added to the cart; can change quantity in the modal |
|
Authentication |
Registration, login, and forgot password |
|
Cart page |
Displays list of items in the cart and purchase summary; allows change of quantity and removal of items |
|
Checkout |
Typical four-step checkout allowing customer to enter shipping and payment details, choose shipping method, and then review before submitting order; new shipping addresses and payment methods are saved automatically; customers can choose from saved shipping addresses and payment methods; confirmation displayed after successful order submission; can replace entire checkout process or is extendable on a step-by-step basis |
|
Order History |
Displays list of orders and details for a specific order; orders are listed by consignment |
|
Address Management |
Displays list of saved shipping addresses; customers can add new shipping addresses, edit and delete shipping addresses, and make set a shipping address as the default |
|
Payment Method Management |
Displays list of saved payment methods; customers can delete payment methods, and make a payment method the default |
|
Account Settings |
Displays and allows customers to edit their name, email address, password and consent preferences; also allows the customer to request account closure |
|
Add to Home |
Allows the customer to add the storefront web app to their device Home or Launch screen, as if the storefront were a native app (search for "PWA Add to Home" for more information) |
Architectural and foundational features:
| Topic/Area | Notes |
|---|---|
|
Decoupled |
Communicates through API's only; uses SAP Commerce Cloud APIs ootb but can connect to microservices or other API-based Internet sources |
|
Upgradable libraries |
Semantic versioning used; recommendation is to use the libraries (don't fork the source code) |
|
Extendable architecture |
Replace existing components with custom components; add custom components before or after existing components; customize component-specific business logic; re-use public internal services |
|
Customizable Styling |
Global variables for ease of branding; precise selectors for fine-tuning styling; also useful for certain simple positioning changes |
|
Responsive Design |
Layouts display properly on devices of different sizes; ootb viewports include mobile, tablet, desktop, wide desktop; configurable |
|
CMS |
Driven almost completely by CMS provided by SAP Commerce Cloud back end; can be used for marketing content and also as placeholders for injecting functionality; can use third-party systems |
|
SmartEdit |
SmartEdit supported; same functionality as in Accelerator (requires SAP Commerce Cloud 1905) |
|
Routing |
Allows configuration of all site URLs (e.g. /products/shoes); configurable in composable storefront application but also controlled by CMS routing configuration defined in the backend (thus editable by SmartEdit); includes default configurations so no customization necessary to get composable storefront working |
|
SSR |
SSR (Server-Side Rendering) supported, where HTML page is rendered on the server instead of on the client; required to for SEO / search site indexing; also improves performance of first time-to-view |
|
SEO |
Stateful URLs for every part of the storefront; search engine indexing supported by way of SSR; configurable routing; page meta resolvers including title, description, image (og:image), and robots |
|
Cache-first networking |
Caching of shell app, with more to come in subsequent releases |
|
Localization |
All front-end texts localizable (texts that are part of the storefront code only; some texts come from backend CMS components, translated in backend) |
|
Builds with CCv2 |
JavaScript applications such as composable storefront-based storefronts can be built alongside SAP Commerce Cloud using SAP Commerce Cloud v2 |
How composable storefront is Versioned
Composable storefront is following semantic versioning (Major.Minor.Patch).
-
A new patch release (1.2.3 > 1.2.4 for example) means we added fixes or improvements but no new features.
-
A new minor release (1.>2.4 > 1.3.0 for example) means we added a new feature and possibly fixes and improvements.
For both patch and minor releases, upgrading to the new libraries should not cause any compatibility problems with your storefront app. (If it does, report a bug.) All new features and fixes are implemented in a compatible way. For example, all new features are disabled by default using feature flags. We hope you will upgrade frequently.
-
A new major release ( 1.3.2 > 2.0.0 for example) means that, besides adding new features and improvements, we made changes that will likely cause compatibility issues. Your app likely needs updating when moving to a new major release. These effects, reasons, and benefits will be documented.
We don't plan to introduce a new major release that frequently, unless an issue is found that makes it necessary to move to a major release . For example, a new major release of the Angular framework is one factor in our decision to move to a new major for composable storefront.
Future Releases
See https://roadmaps.sap.com/
and search for "Commerce" to see results that include roadmap items for the composable storefront.