Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.0 version.
Released: December 10, 2025
Important
This page addresses details related to a specific SPFx release version. This page doesn't include additional SPFx prerequisites that must be installed in order to develop SPFx solutions, including Node.js, Yeoman, and other tools.
To learn more about these prerequisites, see Set up your SharePoint Framework development environment.
Install the latest version
Install the latest release of the SharePoint Framework (SPFx) by using the @latest tag
npm install @microsoft/generator-sharepoint@latest --global
Upgrading projects from the SPFx v1.21.1 to v1.22.0 version
Warning
Upgrading from a previous minor version requires changes across package versions, build configuration files, and toolchain settings that vary depending on your source version. Manually updating package.json alone will result in build failures.
Tip
To upgrade this project, run:
npx -p @pnp/cli-microsoft365 m365 spfx project upgrade --toVersion 1.22.0 --output md
This analyzes your project and outputs all required changes, including a single script to apply them in one go.
Note
The CLI for Microsoft 365 is an open-source solution with active community providing support for it. There is no SLA for the open-source tool support from Microsoft.
For an overview of what changes during this migration from the Gulp-based toolchain to the Heft-based toolchain, see: Migrate from the Gulp Toolchain to Heft Toolchain.
New features and capabilities
Transitioning from Gulp-based toolchain to the Heft-based toolchain
Starting with SPFx v1.22.0, new projects use Heft as the build task orchestrator instead of the 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.
Addressing npm audit issues
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.
Default TypeScript version updated
Scaffolded projects are now using TypeScript v5.8 by default.
Deprecations
No new updates.
Feedback and issues
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! 🧡