SharePoint Framework development tools and libraries compatibility
As the SharePoint Framework (SPFx) evolves, so do the various development tools and libraries that it uses.
SharePoint Framework version compatibility
Because SharePoint Online and the on-premises versions of SharePoint Server have different release cycles for new capabilities, they also have support different SharePoint Framework capabilities.
SharePoint Online always uses the latest version of the SharePoint Framework, but SharePoint 2016 and SharePoint 2019 only support the versions that match the server-side dependencies of the deployed packages.
| SharePoint version | Supported SPFx version | Supported features |
|---|---|---|
| SharePoint Online | All versions | All features |
| SharePoint Server Subscription Edition | v1.5 or lower | SPFx client-side web parts in classic and modern pages, and extensions in modern pages. |
| SharePoint Server 2019 | v1.4.1 or lower | SPFx client-side web parts in classic and modern pages, and extensions in modern pages. |
| SharePoint 2016 Feature Pack 2 | v1.1 | SPFx client-side web parts hosted in classic SharePoint pages. |
For more information about SharePoint Framework development with SharePoint 2016 Feature Pack 2 and SharePoint 2019, see:
- SharePoint Framework development with SharePoint 2016 Feature Pack 2
- SharePoint Framework development with SharePoint Server 2019 and Subscription Edition - this guidance applies also for SharePoint Server Subscription Edition
SPFx development environment compatibility
As each new version of the SharePoint Framework is released, support for newer versions libraries is constantly added to ensure that the toolset remains up to date.
The following table lists SharePoint Framework and compatible versions of common tools and libraries:
| SPFx | Node.js (LTS) | TypeScript | React |
|---|---|---|---|
| 1.20.0 | v18 | v4.5, v4.7 | v17.0.1 |
| 1.19.0 | v18 | v4.5, v4.7 | v17.0.1 |
| 1.18.2 | v16, v18 | v4.5, v4.7 | v17.0.1 |
| 1.18.1 | v16, v18 | v4.5, v4.7 | v17.0.1 |
| 1.18 | v16, v18 | v4.5, v4.7 | v17.0.1 |
| 1.17.4 | v16.13+ | v4.5 | v17.0.1 |
| 1.17.3 | v16.13+ | v4.5 | v17.0.1 |
| 1.17.2 | v16.13+ | v4.5 | v17.0.1 |
| 1.17.1 | v16.13+ | v4.5 | v17.0.1 |
| 1.17.0 | v16.13+ | v4.5 | v17.0.1 |
| 1.16.1 | v16.13+ | v4.5 | v17.0.1 |
| 1.16.0 | v16.13+ | v4.5 | v17.0.1 |
| 1.15.2 | v12, v14, v16 | v4.5 | v16.13.1 |
| 1.15.0 | v12, v14, v16 | v4.5 | v16.13.1 |
| 1.14.0 | v12, v14 | v3.9 | v16.13.1 |
| 1.13.1 | v12, v14 | v3.9 | v16.13.1 |
| 1.13.0 | v12, v14 | v3.9 | v16.13.1 |
| 1.12.1 | v10, v12, v14 | v3.7 | v16.9.0 |
| 1.11.0 | v10 | v3.3 | v16.8.5 |
| 1.10.0 | v8, v10 | v3.3 | v16.8.5 |
| 1.9.1 | v8, v10 | v2.9 | v16.8.5 |
| 1.8.2 | v8, v10 | v2.9 | v16.7.0 |
| 1.8.1 | v8 | v2.7, v2.9, v3 | v16.7.0 |
| 1.8.0 | v8 | v2.7, v2.9, v3 | v16.7.0 |
| 1.7.1 | v8 | v2.4 | v16.3.2 |
| 1.7.0 | v8 | v2.4 | v16.3.2 |
| 1.6.0 | v6, v8 | v2.4 | v15 |
| 1.5.1 | v6, v8 | v2.4 | v15 |
| 1.5.0 | v6, v8 | v2.4 | v15 |
| 1.4.1 | v6, v8 | v2.4 | v15 |
| 1.4.0 | v6 | v2.4 | v15 |
| 1.3.0 | v6 | v2.4 | v15 |
| 1.1.0 | v6 | v2.4 | v15 |
| 1.0.0 | v6 | v2.4 | v15 |