Skip to content

Commit 1cb43b8

Browse files
committed
GA updates for the SPFx 1.21 release
1 parent 354a747 commit 1cb43b8

File tree

4 files changed

+41
-25
lines changed

4 files changed

+41
-25
lines changed

docs/design/use-brand-center-fonts-in-spfx-components.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Use SharePoint brand center fonts in SharePoint Framework solutions
33
description: Developers can use the fonts defined in Brand center in their SharePoint Framework (SPFx) components. This article demonstrates how you can use the fonts defined in the SharePoint brand center in your SPFx components.
4-
ms.date: 10/07/2024
4+
ms.date: 04/23/2025
55
ms.localizationpriority: high
66
---
77

@@ -109,9 +109,12 @@ To test the web part, start the local web browser, but don't launch a browser to
109109
1. In the console, the **gulp serve** command will output a line that looks similar to the following:
110110

111111
```text
112-
[spfx-serve] To load your scripts, use this query string: ?debug=true&noredir=true#debugManifestsFile=https://localhost:4321/temp/manifests.js
112+
[spfx-serve] To load your scripts, use this query string: ?debug=true&noredir=true#debugManifestsFile=https://localhost:4321/temp/build/manifests.js
113113
```
114114

115+
> [!NOTE]
116+
> Debug query string was changed starting from the SPFx verson 1.21 from `https://localhost:4321/temp/manifests.js` to `https://localhost:4321/temp/build/manifests.js`
117+
115118
1. Open the browser and navigate to a page that you have permission to add a web part to the page.
116119
1. Add the query string from the preceding console message to the URL and load the page.
117120

docs/spfx/release-1.21.md

Lines changed: 33 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,29 @@
11
---
22
title: SharePoint Framework v1.21 release notes
33
description: Release notes for the SharePoint Framework v1.21 release.
4-
ms.date: 04/10/2025
4+
ms.date: 04/23/2025
55
ms.localizationpriority: high
66
---
77
# SharePoint Framework v1.21 release notes
88

9-
This release has initial configuration updates for web parts in the context of flexible layouts in SharePoint and personalization option for cards. We're also looking to further include other technical updates before this version is generally available.
9+
This release has updates on the Nodejs version and on other technical dependencies. It also contains updates for web parts in the context of flexible layouts in SharePoint and personalization option for cards.
1010

1111
> [!NOTE]
12-
> [SharePoint Framework API Reference](https://learn.microsoft.com/en-us/javascript/api/overview/sharepoint?view=sp-typescript-latest) was also updated to match the latest 1.21 version as part of the beta 2 release.
12+
> [SharePoint Framework API Reference](https://learn.microsoft.com/en-us/javascript/api/overview/sharepoint?view=sp-typescript-latest) has been also updated to match the latest 1.21 version.
1313
14-
[!INCLUDE [spfx-release-beta](../../includes/snippets/spfx-release-beta.md)]
15-
16-
* rc.0 **Released:** April 10, 2025
17-
* beta.2 **Released:** April 3, 2025
18-
* beta.0 **Released:** February 25, 2025
14+
**Released:** April 23, 2025
1915

2016
[!INCLUDE [spfx-release-notes-common](../../includes/snippets/spfx-release-notes-common.md)]
2117

2218
## Install the latest version
2319

24-
Install the latest generally available release of the SharePoint Framework (SPFx) by using the **@next** tag
20+
Install the latest generally available release of the SharePoint Framework (SPFx) by using the **@latest** tag
2521

2622
```console
27-
npm install @microsoft/generator-sharepoint@next --global
23+
npm install @microsoft/generator-sharepoint@latest --global
2824
```
2925

30-
## Upgrading projects from the SPFx v1.20 to v1.21 release candiate version
26+
## Upgrading projects from the SPFx v1.20 to v1.21 version
3127

3228
In the project's **package.json** file, identify all SPFx v1.20 packages. For each SPFx package:
3329

@@ -37,10 +33,10 @@ In the project's **package.json** file, identify all SPFx v1.20 packages. For ea
3733
npm uninstall @microsoft/{spfx-package-name}@1.20
3834
```
3935

40-
1. Install the new v1.21 preview package:
36+
1. Install the new v1.21 package:
4137

4238
```console
43-
npm install @microsoft/{spfx-package-name}@next --save --save-exact
39+
npm install @microsoft/{spfx-package-name}@latest --save --save-exact
4440
```
4541

4642
[!INCLUDE [spfx-release-upgrade-tip](../../includes/snippets/spfx-release-upgrade-tip.md)]
@@ -49,13 +45,14 @@ In the project's **package.json** file, identify all SPFx v1.20 packages. For ea
4945

5046
### Node.js v22 support
5147

52-
Node.js support will be updated to the version 22 with the 1.21 release. This beta build is the first version to include version 22 support.
48+
Node.js support has been updated to version 22 with the 1.21 release.
5349

54-
Notice that when SPFx 1.21 is generally available, Node.js version 22 is the only supported version with it. Currently SPFx supports Node.js version 18, which will fall out of the support in end of April 2025. We are planning to have SPFx 1.21 generally available before that date.
50+
> [!NOTE]
51+
> Notice that Node.js version 22 is the only supported version with version 1.21.
5552

5653
### TypeScript 5.x support
5754

58-
Starting with this first release candidate for the 1.21 release, we have also updated the support for the TypeScript 5.x. Default scaffolded projects are using currently specifically 5.3.3 version by default.
55+
TypeScript has been updated to TypeScript 5.x. Default scaffolded projects are using currently specifically 5.3.3 version by default.
5956

6057
### Flexible layout configuration options for web parts
6158

@@ -70,15 +67,15 @@ New flexible layout sizing options are introduced for the web part manifest. The
7067
```
7168

7269
> [!NOTE]
73-
> By default all custom web parts are supported in the flexible layout option and don't require any code level changes.
70+
> By default, all custom web parts are supported in the flexible layout option and don't require any code level changes.
7471
7572
![Flexible layout support](../images/121-release-notes/flex-layout.png)
7673

7774
### Viva Connections card personalization support
7875

79-
Viva Connections will start supporting end user configuration options for the dashboard. End users can add and remove cards from the dashboard based on their preference. Supported cards are explicitly enabled for this scenario and also custom cards are supported.
76+
Viva Connections will start supporting end user configuration options for the dashboard. End users can add and remove cards from the dashboard based on their preference. Supported cards are explicitly enabled for this scenario and custom cards are supported.
8077

81-
By default personalization isn't allowed for the custom Viva Connections cards.
78+
By default, personalization isn't allowed for the custom Viva Connections cards.
8279

8380
```json
8481
"personalization": [
@@ -92,6 +89,20 @@ By default personalization isn't allowed for the custom Viva Connections cards.
9289

9390
Default [Teams JavaScript SDK](https://github.com/OfficeDev/microsoft-teams-library-js) version for the SPFx powered solutions has been updated to version 2.32.
9491

92+
## Changes
93+
94+
Default debugging URL location was changed as part of the release. `debugManifestsFile` is updated as `https://localhost:4321/temp/build/manifests.js`. This might have impact on any tooling or scripts which have previously taken a dependency on this URL. Please update your those accordingly with this change.
95+
96+
*Previous versions*
97+
```
98+
[spfx-serve] To load your scripts, use this query string: ?debug=true&noredir=true&debugManifestsFile=https://localhost:4321/temp/manifests.js
99+
```
100+
101+
*Updated debugManifestFile URL starting from 1.21 version*
102+
```
103+
[spfx-serve] To load your scripts, use this query string: ?debug=true&noredir=true&debugManifestsFile=https://localhost:4321/temp/build/manifests.js
104+
```
105+
95106
## Deprecations
96107

97108
No new updates.
@@ -102,6 +113,8 @@ No new updates.
102113

103114
## Feedback and issues
104115

105-
We're interested on your feedback around the release. Do let us know any findings or other feedback using the [SPFx issue list](https://github.com/SharePoint/sp-dev-docs/issues).
116+
We're interested in your feedback about the release. Do let us know any findings or other feedback using the [SPFx issue list](https://github.com/SharePoint/sp-dev-docs/issues).
117+
118+
We will be doing some cleaning in the issue list after the 1.21 release to better focus on the latest issues and are more focused on helping you with any of your findings.
106119

107120
Happy coding! Sharing is caring! 🧡

docs/spfx/web-parts/get-started/build-a-hello-world-web-part.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Build your first SharePoint client-side web part (Hello World part 1)
33
description: Create a new web part project and preview it.
4-
ms.date: 11/02/2023
4+
ms.date: 04/23/2025
55
ms.localizationpriority: high
66
ms.custom: scenarios:getting-started
77
---
@@ -98,7 +98,7 @@ Build target: DEBUG
9898
[12:13:24] Starting 'serve'...
9999
[12:13:24] Starting gulp
100100
[12:13:24] Starting subtask 'spfx-serve'...
101-
[12:13:24] [spfx-serve] To load your scripts, use this query string: ?debug=true&noredir=true&debugManifestsFile=https://localhost:4321/temp/manifests.js
101+
[12:13:24] [spfx-serve] To load your scripts, use this query string: ?debug=true&noredir=true&debugManifestsFile=https://localhost:4321/temp/build/manifests.js
102102
[12:13:25] Starting server...
103103
[12:13:25] Finished subtask 'spfx-serve' after 1.24 s
104104
[12:13:25] Starting subtask 'pre-copy'...

docs/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -474,7 +474,7 @@
474474
items:
475475
- name: Overview
476476
href: spfx/roadmap.md
477-
- name: SPFx v1.21 - April 10, 2025
477+
- name: SPFx v1.21 - April 23, 2025
478478
href: spfx/release-1.21.md
479479
- name: SPFx v1.20 - September 26, 2024
480480
href: spfx/release-1.20.md

0 commit comments

Comments
 (0)