Skip to content

Doc review: Update Release 221121.7#1596

Open
gladius-mtl wants to merge 10 commits intodevelopfrom
doc/CXSPA-12154
Open

Doc review: Update Release 221121.7#1596
gladius-mtl wants to merge 10 commits intodevelopfrom
doc/CXSPA-12154

Conversation

@gladius-mtl
Copy link
Contributor

No description provided.

Comment on lines +37 to +44
imports: [
StoreModule.forRoot({}),
AppRoutingModule,
EffectsModule.forRoot([]),
SpartacusModule
],
providers: [
],
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The imports and providers array might contain other customer's custom items. that's why in the original code snippet I added /*...*/.

Comment on lines +201 to +212
Specifically, remove `provideClientHydration(withEventReplay(), withNoHttpTransferCache())` from the `providers` array. Your `app.module.ts` file should look as follows:

```ts
@NgModule({
/* ... */
providers: [
/* ... */
],
})
export class AppModule { }
};
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Specifically, remove `provideClientHydration(withEventReplay(), withNoHttpTransferCache())` from the `providers` array. Your `app.module.ts` file should look as follows:
```ts
@NgModule({
/* ... */
providers: [
/* ... */
],
})
export class AppModule { }
};
```
Specifically, remove `provideClientHydration(withEventReplay(), withNoHttpTransferCache())` from the `providers` array. Your `app.module.ts` file should look as follows:
```ts
@NgModule({
/* ... */
providers: [
/* ... there should be no `provideClientHydration(withEventReplay(), withNoHttpTransferCache())` */
],
})
export class AppModule { }
};


## Next
Now, consider migrating your custom components to Standalone Components, by following this guide: [Standalone Components in Spartacus since 221121.7.0 -> Migrating Your Custom Components to Standalone Components](./standalone-components-in-spartacus.md#migrating-your-custom-components-to-standalone-components).
Although not required, it is also recommended that you migrate your custom components to standalone components. For more information, see [Migrating to Standalone Components in Spartacus](standalone-components-in-spartacus.md).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Although not required, it is also recommended that you migrate your custom components to standalone components. For more information, see [Migrating to Standalone Components in Spartacus](standalone-components-in-spartacus.md).
It is also strongly recommended that you migrate your custom components to standalone components. For more information, see [Migrating to Standalone Components in Spartacus](standalone-components-in-spartacus.md).

Comment on lines -13 to -14
### NgModules are still in use
Angular `NgModules` are still in use in Spartacus just for organizing features into cohesive modules, but no longer for declaring components.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we left this separate doc, then only this sentence would remain, as we agreed offline.
I understand you decided to remove this doc alltoghether, because this sentence was too little to justify a separate doc for it. Works for me 👍

Comment on lines +111 to +115
```bash
ng update @angular/core@21 @angular/cli@21 @ngrx/store@21 angular-oauth2-oidc@20 @ng-select/ng-select@21 ngx-infinite-scroll@21 --force
git add .
git commit -m "update angular 21 and 3rd party deps angular 21 compatible"
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The usage of v20 instead of v21 for angular-oauth2-oidc@20 might be confusing for customers. they might create support requests suggesting it's a typo.

What about adding a disclaimer that at the time of the release, the latest available version of angular-oauth2-oidc is v20, but the author of the library says it works also with Angular 21 as well. Source: manfredsteyer/angular-oauth2-oidc#1491 (comment)

If your storefront application does use SSR, you must enable non-destructive hydration. Enabling non-destructive hydration aligns your app with current Angular best practices, making it easier to maintain and update your storefront application.
#### How to enable it
Non-destructive hydration is an Angular feature that improves performance by reusing the server-rendered DOM instead of destroying and recreating it on the client side. This reduces the Time to Interactive (TTI) metric and provides a better user experience.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Non-destructive hydration is an Angular feature that improves performance by reusing the server-rendered DOM instead of destroying and recreating it on the client side. This reduces the Time to Interactive (TTI) metric and provides a better user experience.
Non-destructive hydration is an Angular feature that improves performance by reusing the server-rendered DOM instead of destroying and recreating it on the client side. This helps to avoid a flickering when transitioning from server-side DOM to client-side rendered DOM in the browser, which provides a better user experience.

Comment on lines 184 to 201
@@ -202,253 +199,94 @@ export const appConfig: ApplicationConfig = {
};
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm sorry, I realized only now this paragraph is targeted to non-existing audience.

At this time or reading the document, customers' apps are likely not yet migrated to standalone. So I guess we can remove this paragraph and code snippet.

Only in the next section below ## Modernizing Your Storefront to Use the Standalone Bootstrap Application we'll tell customers to move this provideClientHydration() call from app.module.ts to app.config.ts.

##### Known Warning: NG05001
### Known Warning: NG05001

After enabling hydration, you may see the following warning in your console:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
After enabling hydration, you may see the following warning in your console:
After enabling hydration, you may see the following warning in your console in dev-mode build:

```
Spartacus provides dedicated schematics to automatically modernize your app to use the Angular `bootstrapApplication()` API and convert your root `AppComponent` to a standalone component.
**Note:** The schematics to modernize your app only migrate your root `AppComponent` to become a standalone component. The schematics do not migrate your custom components to become standalone components. For more information about migrating your custom components, see [Standalone Components in Spartacus](#standalone-components-in-spartacus).
Copy link
Contributor

@Platonn Platonn Feb 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**Note:** The schematics to modernize your app only migrate your root `AppComponent` to become a standalone component. The schematics do not migrate your custom components to become standalone components. For more information about migrating your custom components, see [Standalone Components in Spartacus](#standalone-components-in-spartacus).
**Note:** The schematics to modernize your app only migrate your root `AppComponent` to become a standalone component. The schematics do not migrate your custom components to become standalone components. For more information about migrating your custom components, see [Standalone Components in Spartacus](#standalone-components-in-spartacus). But before migrating all your custom components to standalone, please follow the migration described here below.

gladius-mtl and others added 2 commits February 19, 2026 08:24
…dalone-bootstrap-application.md

Co-authored-by: Krzysztof Platis <platonn.git@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

Comments