Recenlty i decided to update the spfx libs of my webparts project to the v1.12.1 I have followed the steps indicated in the official Microsoft documentation: https://docs.microsoft.com/es-es/sharepoint/dev/spfx/release-1.12.1

Now I realized that gulp serve has been replaced with: 'gulp serve-deprecated'. So Ive gone to the official documentation and I have read this:

Local workbench is deprecated - This is the last release that will include support for the local workbench. - https://docs.microsoft.com/en-us/sharepoint/dev/spfx/release-1.12.1#deprecations-and-removed-items-in-this-release

So my question now is: how is supposed to work with web parts development now or in the future?

If i cant test my web parts with gulp serve how is supposed I can to test them?

2 Answers 2


Below are requirement to run and test SPFx 1.12.1 webpart.

node version  v14.15.5

+-- @microsoft/[email protected]
+-- [email protected]
+-- [email protected]
`-- [email protected]

gulp serve will work with current release and with the next release.

local work bench will work with current SPFx version 1.12.1. In next release it won't be supported.

You can test your webpart in SharePoint workbench instead of local workbench.

You change the URL of local work bench in sever.json file so that gulp serve will open this URL always.

"initialPage": "https://Yourtenant.sharepoint.com/sites/POC/_layouts/15/workbench.aspx"

Please accept the answer & upvote it if you are satisfied with answer.

  • Theres no a gulp serve command in the current release. Theres a gulp serve-deprecated instead. Thats why im asking what way is supposed to be followed in next releases to aproach the webpart development. Thank u for your answer and for the way to test webparts under SP workbench. May 7, 2021 at 8:44
  • If you run "gulp --tasks" command you will get gulp serve and gulp serve-deprecated both. please check. May 7, 2021 at 16:08
  • Nope. Only serve-deprecated available. I did a workaround to make gulp serve available again: var getTasks = build.rig.getTasks; build.rig.getTasks = function () { var result = getTasks.call(build.rig); result.set('serve', result.get('serve-deprecated')); return result; }; May 9, 2021 at 13:12
  • Daniel, read through the release notes of 1.12.1 it explains how to bring back gulp serve (map it to the deprecated name). This is required to be able to run the gulp serve. As for the future - we don't know yet what would be replacing gulp serve... but I am assuming something similar that will only work with the online workbench.
    – Shai Petel
    Aug 25, 2021 at 18:19

Note that https://docs.microsoft.com/en-us/sharepoint/dev/spfx/release-1.12.1 has recently been updated, indicating that you need to update your gulpfile.js to be able to run gulp serve

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.