A while ago, I was looking for an official list of which version of SPFx is compatible with each SharePoint version, but I couldn't find what I wanted.
I kinda forgot about it until today, when someone reached out to me and asked me if I had a SPFX/SharePoint compatibility matrix handy.
As I turns out, I had created such a matrix when I wrote my SPFX timeline.
So, as I am the world's laziest developer, I figured it would be very little effort to put such a matrix together by leveraging work I had already done.
The list in this post is not an official list; it is based on my interpretation of the SPFx release notes. If you find an error in it, please let me know and I'll fix it.
SPFx Version Compatibility
|SharePoint Version||Supported SPFx version||Notes|
|SharePoint Online||All versions|
|SharePoint Server 2019||v1.4.1 or lower|
|SharePoint Server 2016||v1.1||Requires Feature Pack 2|
SPFx Development Environment Compatibility
|1.9.0||LTS 8.x, LTS 10.x||v5||v2.9||v16.8.5|
|1.8.2||LTS 8.x, LTS 10.x||v5||v2.9||v16.7.0|
|1.8.1||LTS 8.x||v5||v2.7, v2.9, v3.x||v16.7.0|
|1.8.0||LTS 8.x||v5||v2.7, v2.9, v3.x||v16.7.0|
|1.6.0||LTS 6.x, LTS 8.x||v5||v2.4||v15.x|
|1.5.1||LTS 6.x, LTS 8.x||v5||v2.4||v15.x|
|1.5.0||LTS 6.x, LTS 8.x||v3.x||v2.4||v15.x|
|1.4.1||LTS 6.x, LTS 8.x||v3.x, v4.x||v2.4||v15.x|
|1.4.0||LTS 6.x||v3.x, v4.x||v2.4||v15.x|
|1.2.0||LTS 6.x||v3.x, v4.x||v2.4||v15.x|
|1.1.0||LTS 6.x||v3.x, v4.x||v2.4||v15.x|
If I made any mistakes in the list above, please do not hesitate to write in the comments. I'll gladly update my matrix.
I still think that there should be an official compatibility list something in the SharePoint Documentation.
Maybe I should just submit a PR to the SP Dev Docs repo and hope the community will help me keep my compatibility matrix accurate?
- Thanks to David Warner II for the inspiration for this post and for helping fix my mistakes
- While doing my research for this post, I found Andrew Connell has also written a handy article.
- January 12, 2020: I love it when people take the time to write in comments to help me keep content up-to-date! Thank you Ronald Borman for the many corrections to my matrix. Keep 'em coming!
- January 2, 2020: Thanks to David Warner II for pointing out that Andrew Connell has an awesome article on how to use NVM as a better Node package manager. It is a great solution if you need to run multiple versions of Node.js on the same environment.