| title | SharePoint Framework v1.22 release notes |
|---|---|
| description | Release notes for the SharePoint Framework v1.22 release. |
| ms.date | 12/11/2025 |
| ms.localizationpriority | high |
This release focused on updating and modernizing the SharePoint Framework (SPFx) build toolchain and to address all known 'npm audit' reported vulnerabilities in the Yeoman package and in the scaffolded projects.
Note
SharePoint Framework API Reference has been also updated to match the latest 1.22 version.
Released: December 10, 2025
[!INCLUDE spfx-release-notes-common]
Install the latest release of the SharePoint Framework (SPFx) by using the @latest tag
npm install @microsoft/generator-sharepoint@latest --globalThe upgrade steps required to convert a gulp-based toolchain SPFx project to the Heft-based toolchain are detailed in the following article: Migrate from the Gulp Toolchain to Heft Toolchain.
Starting with SPFx v1.22, new projects use Heft as the build task orchestrator instead of a gulp-based toolchain used in SPFx v1.0 - v1.21.1 releases. This change represents a fundamental shift in how SPFx projects are built, configured, and customized, though the underlying bundling technology (webpack) remains the same.
See more details on this upcoming change from the following documentation:
When installing the SharePoint Framework Yeoman generator, there are no longer any npm audit issues.
All scaffolded projects from the SharePoint Framework Yeoman generator have been cleaned and there are no reported vulnerabilities in them when you run npm audit after the scaffolding.
We are also looking into addressing deprecated packages in the following releases of SharePoint Framework.
Scaffolded projects are now using TypeScript v5.8 by default.
No new updates.
We're interested in your feedback about the release and if you find any issues, please share them using the sp-dev-docs repository issue list. We are also tracking any other discussions if you simply want to have a discussion with the engineering team on this release. Thank you for your input advance.
Happy coding! Sharing is caring! 🧡