From 7a1bfe1c763d8990d4ea0be92eea97124345d3dc Mon Sep 17 00:00:00 2001
From: sumeyye <sum.the.developer@gmail.com>
Date: Thu, 26 Feb 2026 16:40:43 +0300
Subject: [PATCH] update: migration guide

---
 .../release-info/migration-guides/abp-10-1.md | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/docs/en/release-info/migration-guides/abp-10-1.md b/docs/en/release-info/migration-guides/abp-10-1.md
index 34900131c2..341b1827d0 100644
--- a/docs/en/release-info/migration-guides/abp-10-1.md
+++ b/docs/en/release-info/migration-guides/abp-10-1.md
@@ -47,6 +47,49 @@ In this version, we added password history/ user passkeys support to the [Identi
 
 > See [#23894](https://github.com/abpframework/abp/pull/23894) for more details.
 
+### Angular Version Upgraded to v21
+
+ABP now targets Angular v21 (up from v20). For existing Angular projects, apply these changes:
+
+- **TypeScript:** Update to `~5.9.0`
+- **main.ts:** Add `provideZoneChangeDetection()` to the bootstrap config:
+  ```ts
+    // angular/src/main.ts
+    bootstrapApplication(AppComponent, {
+        ...appConfig,
+        providers: [provideZoneChangeDetection(), ...appConfig.providers],
+    }).catch(err => console.error(err));
+  ```
+- **tsconfig.json:** Align with the new property formats to avoid build issues:
+  ```json
+    /* angular/tsconfig.json */
+    /* To learn more about this file see: https://angular.io/config/tsconfig. */
+    {
+      "compileOnSave": false,
+      "compilerOptions": {
+        "baseUrl": "./",
+        "outDir": "./dist/out-tsc",
+        "sourceMap": true,
+        "declaration": false,
+        "esModuleInterop": true,
+        "experimentalDecorators": true,
+        "moduleResolution": "bundler",
+        "importHelpers": true,
+        "skipLibCheck": true,
+        "target": "ES2022",
+        "module": "ES2022",
+        "lib": ["ES2022", "dom", "esnext.disposable"],
+        "paths": {},
+        "useDefineForClassFields": false
+      },
+      "angularCompilerOptions": {
+        "enableI18nLegacyMessageIdFormat": false
+      }
+    }
+  ```
+
+For more details, see the [Angular version reference](https://angular.dev/reference/versions#actively-supported-versions).
+
 ## PRO
 
 > Please check the **Open-Source (Framework)** section before reading this section. The listed topics might affect your application and you might need to take care of them.