{"id":25104,"date":"2025-12-10T14:44:41","date_gmt":"2025-12-10T22:44:41","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=25104"},"modified":"2025-12-10T14:44:41","modified_gmt":"2025-12-10T22:44:41","slug":"general-availability-of-sharepoint-framework-1-22-a-major-refresh-of-the-build-tooling-experience","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/general-availability-of-sharepoint-framework-1-22-a-major-refresh-of-the-build-tooling-experience\/","title":{"rendered":"General Availability of SharePoint Framework 1.22 &#8211; A Major Refresh of the Build &#038; Tooling Experience"},"content":{"rendered":"<p>We are excited to announce general availability of the\u00a0<strong>SharePoint Framework (SPFx) 1.22 \u2013 with a focus on refreshing the build and toolchain areas<\/strong>. <a href=\"https:\/\/aka.ms\/spfx\">SharePoint Framework<\/a> is the easiest and the most widely used model to build your enterprise solutions for Microsoft 365 with automatic single sign-on, automatic hosting and with industry standard web stack tooling. Key objective of the 1.22 release is to setup a new baseline to further accelerate investments for the SharePoint Framework across Microsoft 365 areas. We are thrilled to see the continuous interest on SPFx and continue providing updates on the roadmap with our <a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/sharepoint-framework-spfx-roadmap-update-november-2025\/\">monthly SPFx roadmap updates<\/a>.<\/p>\n<p><strong>Your input and feedback have been invaluable<\/strong> to define the key features for our releases, both current and future. <strong>Thank you \ud83d\udc4f<\/strong><\/p>\n<p>You can find the full list of released details from the following documentation:<\/p>\n<ul>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/sharepoint\/dev\/spfx\/release-1.22\" target=\"_blank\" rel=\"noopener\">SharePoint Framework 1.22 release notes<\/a><\/li>\n<\/ul>\n<h2>Key features in the 1.22 release \ud83d\udcdd<\/h2>\n<p>Key changes and updates in this release are as follows:<\/p>\n<ul>\n<li>Transitioning from Gulp-based toolchain to <strong>Heft-based toolchain<\/strong>.\n<ul>\n<li>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 &#8211; 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.<\/li>\n<li>See more details from following documentation: <a href=\"https:\/\/learn.microsoft.com\/en-us\/sharepoint\/dev\/spfx\/toolchain\/sharepoint-framework-toolchain-rushstack-heft\">SharePoint Framework Toolchain: Heft &amp; Webpack<\/a>.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<ul>\n<li>Addressing <strong>npm audit issues<\/strong> in Yeoman package and on scaffolded solutions.\n<ul>\n<li>Previous versions of SPFx had npm audit reported issues, which have been all addressed with the 1.22 release. We are also working on updating the deprecated packages in upcoming versions.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p style=\"padding-left: 40px;\"><a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/11\/spfx-audit-zero.webp\"><img decoding=\"async\" class=\"alignnone size-full wp-image-25054\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/11\/spfx-audit-zero.webp\" alt=\"spfx audit zero image\" width=\"615\" height=\"351\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/11\/spfx-audit-zero.webp 615w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/11\/spfx-audit-zero-300x171.webp 300w\" sizes=\"(max-width: 615px) 100vw, 615px\" \/><\/a><\/p>\n<ul>\n<li>Updating default TypeScript version for the scaffolded projects to TypeScript v5.8<\/li>\n<\/ul>\n<p>and more \ud83d\ude80<\/p>\n<p>You can see a live demo of the Heft based toolchain changes from the recording of the weekly Microsoft 365 &amp; Power Platform community call on 25th of November. <a href=\"https:\/\/www.youtube.com\/watch?v=S7CTtR3yaqM&amp;t=2082s\">Specific SPFx 1.22 Heft tooling focused demo starts at 34:42<\/a>.<\/p>\n<p><iframe title=\"Microsoft 365 &amp; Power Platform weekly call \u2013 25th of November, 2025\" src=\"https:\/\/www.youtube.com\/embed\/S7CTtR3yaqM\" width=\"1000\" height=\"562\" frameborder=\"0\" allowfullscreen=\"allowfullscreen\"><span data-mce-type=\"bookmark\" style=\"display: inline-block; width: 0px; overflow: hidden; line-height: 0;\" class=\"mce_SELRES_start\">\ufeff<\/span><\/iframe><\/p>\n<p>Everyone is welcome to these weekly calls to stay up to date on the Microsoft 365 &amp; Power Platform topics. See details on the community calls from <a href=\"https:\/\/aka.ms\/community\/calls\">https:\/\/aka.ms\/community\/calls<\/a>.<\/p>\n<h2 id=\"installing-sharepoint-framework-1-13-preview\">Installing SharePoint Framework 1.22\u00a0 \ud83d\udc69\u200d\ud83d\udcbb<i class=\"fabric-icon fabric-icon--Link\" aria-hidden=\"true\"><\/i><\/h2>\n<p>You can install\u00a0<strong>SharePoint Framework 1.22 <\/strong>by using the following command which will install always the latest generally available version.<\/p>\n<pre tabindex=\"0\"><span class=\"pl-c1\">npm install @microsoft\/generator-sharepoint@latest --global\r\n\r\n<\/span><\/pre>\n<h2 id=\"whats-sharepoint-framework\">What\u2019s SharePoint Framework? \ud83d\ude80<i class=\"fabric-icon fabric-icon--Link\" aria-hidden=\"true\"><\/i><\/h2>\n<p data-start=\"385\" data-end=\"761\">The SharePoint Framework (SPFx) is the leading extensibility model for Microsoft 365, powering custom solutions used by <strong data-start=\"504\" data-end=\"545\">tens of millions of users every month<\/strong> across <strong data-start=\"553\" data-end=\"604\">Microsoft Teams, Microsoft Viva, and SharePoint<\/strong>. SPFx enables developers, partners, and organizations to deliver tailored, high-value experiences that integrate seamlessly with the Microsoft 365 platform.<\/p>\n<p data-start=\"763\" data-end=\"1014\">Designed around modern web standards and built for Microsoft 365\u2019s multi-host ecosystem, SPFx provides a streamlined way to create solutions that are secure, reliable, and reusable &#8211; maximizing your development investment and accelerating time-to-value.<\/p>\n<p data-start=\"1016\" data-end=\"1277\">Whether you\u2019re generating your first project with the<a href=\"https:\/\/learn.microsoft.com\/en-us\/sharepoint\/dev\/spfx\/set-up-your-development-environment\"> SPFx Yeoman Generator<\/a> or using the <a href=\"https:\/\/github.com\/pnp\/vscode-viva\">SharePoint Framework Toolkit<\/a>, SPFx offers a consistent, flexible path to build and ship solutions across Microsoft 365 without rewriting your code for each surface.<\/p>\n<p>Key capabilities of the SharePoint Framework for\u00a0<span class=\"brand\">Microsoft 365<\/span> are the following:<\/p>\n<ul>\n<li><strong>Build once, run everywhere<\/strong> &#8211; Use the <strong data-start=\"1391\" data-end=\"1454\">same component across SharePoint, Microsoft Teams, and Viva<\/strong> without modifying your code. This cross-platform capability reduces development overhead and ensures a unified experience for end users.<\/li>\n<li><strong>Zero-maintenance, automatic hosting<\/strong> &#8211; SPFx solutions are <strong data-start=\"1658\" data-end=\"1696\">automatically hosted in SharePoint<\/strong>, eliminating infrastructure management and reducing operational cost. You focus on innovation &#8211; Microsoft 365 handles the hosting without extra cost.<\/li>\n<li><strong>Seamless, Built-in Single Sign-On (SSO)<\/strong> &#8211; SPFx provides <strong data-start=\"1891\" data-end=\"1941\">automatic SSO across Microsoft 365 experiences<\/strong>. No extra consent prompts, no additional configuration, and no security overhead for end users or admins.<\/li>\n<li><strong>Content-driven, intelligent applications<\/strong> &#8211; Surface Microsoft 365 data via <strong data-start=\"2131\" data-end=\"2150\">Microsoft Graph<\/strong> or integrate external systems to create rich, context-aware applications tightly aligned with organizational content and workflows.<\/li>\n<li><strong>Powered by industry-standard web development<\/strong> &#8211; Built on modern web technologies: <strong data-start=\"1136\" data-end=\"1164\">Node.js, npm, TypeScript<\/strong>, and your preferred JavaScript framework. SPFx avoids proprietary tooling and enables broad skillset reuse.<\/li>\n<li><strong>Centralized governance and administration<\/strong> &#8211; Administrators can manage SPFx solutions from a <strong data-start=\"1375\" data-end=\"1405\">central, unified interface<\/strong>, enabling streamlined deployment, consistent governance, and secure permission approval across Microsoft 365. This ensures organizations maintain full control over what solutions run in their environment and the data they can access.<\/li>\n<li><strong>Built for enterprise scale<\/strong> &#8211; SPFx aligns with Microsoft 365\u2019s <strong>security, compliance, and lifecycle management<\/strong> standards, making it ideal for enterprise-grade and partner-delivered solutions.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<pre tabindex=\"0\"><span class=\"pl-c1\"><a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/12\/spfx-feature-mapping.webp\"><img decoding=\"async\" class=\"alignnone size-large wp-image-25108\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/12\/spfx-feature-mapping-1024x576.webp\" alt=\"SharePoint Framework used by 10s of millions of users each month\" width=\"1024\" height=\"576\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/12\/spfx-feature-mapping-1024x576.webp 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/12\/spfx-feature-mapping-300x169.webp 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/12\/spfx-feature-mapping-768x432.webp 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/12\/spfx-feature-mapping-1536x865.webp 1536w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2025\/12\/spfx-feature-mapping.webp 1549w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a>\r\n\r\n<\/span><\/pre>\n<h2 id=\"additional-resources-and-support\">Additional resources and support \ud83e\udd1d<i class=\"fabric-icon fabric-icon--Link\" aria-hidden=\"true\"><\/i><\/h2>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li>Please report any issues or feedback using following issue list \u2013 <a href=\"https:\/\/aka.ms\/spfx-issues\">https:\/\/aka.ms\/spfx\/issues<\/a>\n<ul>\n<li>We have engineering people monitoring any incoming issues and helping you to get unblocked or getting your questions answered.<\/li>\n<\/ul>\n<\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/sharepoint\/dev\/spfx\/sharepoint-framework-overview?WT.mc_id=m365-47395-cxa\">Overview documentation<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/sharepoint\/dev\/spfx\/web-parts\/get-started\/build-a-hello-world-web-part?WT.mc_id=m365-47395-cxa\">Getting started documentation<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/sharepoint\/dev\/spfx\/build-for-teams-overview?WT.mc_id=m365-47395-cxa\">Build for Microsoft Teams using SharePoint Framework<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/sharepoint\/dev\/spfx\/viva\/overview-viva-connections?WT.mc_id=m365-47395-cxa\">Overview of Viva Connections Extensibility<\/a><\/li>\n<li><a href=\"https:\/\/aka.ms\/m365\/dev\/learn\/connections\">Microsoft Learn &#8211; Extend Microsoft Viva Connections<\/a><\/li>\n<li><a href=\"https:\/\/aka.ms\/spfx\/toolkit\">SharePoint Framework Toolkit<\/a><\/li>\n<li><a href=\"https:\/\/pnp.github.io\/cli-microsoft365\/cmd\/spfx\/project\/project-upgrade\/\" target=\"_blank\" rel=\"noopener\">CLI for Microsoft 365<\/a>\u00a0\u2013 SharePoint Framework Upgrade tooling from previous versions to latest<\/li>\n<li><a href=\"https:\/\/aka.ms\/spfx-webparts\" target=\"_blank\" rel=\"noopener\">SharePoint Framework web part samples<\/a><\/li>\n<li><a href=\"https:\/\/aka.ms\/viva\/samples\">Viva Connections samples<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>If you are looking to build experiences for <span class=\"brand\">Microsoft 365<\/span>, we strongly recommend joining our community calls and other <a href=\"https:\/\/aka.ms\/community\/home\"><span class=\"brand\">Microsoft 365<\/span> &amp; Power Platform Community<\/a> activities covering Microsoft 365 Copilot, SharePoint, Power Platform, Microsoft Teams, Power Apps, Microsoft Viva, and more&#8230; More details here <a href=\"https:\/\/aka.ms\/community\/home\">https:\/\/aka.ms\/community\/home<\/a> \ud83d\ude80<\/p>\n<p>And, follow us on <a href=\"https:\/\/www.linkedin.com\/showcase\/microsoft365dev\">LinkedIn<\/a> or in <a href=\"https:\/\/x.com\/microsoft365dev\">X<\/a> to stay up to date on Microsoft 365 Platform announcements.<\/p>\n<p>Happy coding! Sharing is caring!\u00a0<a class=\"lightbox-link\" href=\"https:\/\/s.w.org\/images\/core\/emoji\/13.1.0\/svg\/1f9e1.svg\" target=\"_blank\" rel=\"noopener\" aria-label=\"Lightbox image, click or press enter to enlarge\" data-featherlight=\"image\"><img decoding=\"async\" class=\"emoji\" role=\"img\" draggable=\"false\" src=\"https:\/\/s.w.org\/images\/core\/emoji\/13.1.0\/svg\/1f9e1.svg\" alt=\"\ud83e\udde1\" \/><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>We are excited to announce general availability for the SharePoint Framework 1.22. This time focus is primarily on updating the build toolchain and to address npm audit issues.<\/p>\n","protected":false},"author":69217,"featured_media":25106,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,128,142,166,9],"tags":[307,306,225,223,116,162,19,221,123],"class_list":["post-25104","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-365-developer","category-microsoft-teams","category-microsoft-viva","category-sharepoint","category-sharepoint-framework","tag-corporate-communications","tag-employee-experiences","tag-microsoft-365","tag-microsoft-teams","tag-microsoft-viva","tag-sharepoint","tag-sharepoint-framework","tag-spfx","tag-viva-connections"],"acf":[],"blog_post_summary":"<p>We are excited to announce general availability for the SharePoint Framework 1.22. This time focus is primarily on updating the build toolchain and to address npm audit issues.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/25104","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69217"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=25104"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/25104\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25106"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=25104"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=25104"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=25104"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}