You may have noticed that you have to deploy your theme manually each time you
make a change. This can become tedious during the development process. The
gulp watch task lets you preview changes to your theme without requiring a
Follow these steps to preview changes to your theme automatically:
Enable Developer Mode in your server. Without this enabled, the gulp watch task will not work.
Navigate to your theme’s root folder and run
gulp watch. This sets up a proxy for your app server (
http://localhost:9080) and opens it in a new window in the browser. It also provides an IP address for you to view your app server across all devices connected to the local network. The browser is synced across all devices that use the given IP address.
Make a change to your theme and save the file. The updated files are built, compiled, and copied directly to port
9080. CSS changes are deployed live, so no page reload is needed. For JS and template changes, you must reload the browser to see the changes.
Once you’re happy with the previewed changes, deploy your theme to your app server to apply the changes.
Configuring Your Theme’s App Server
Copying an Existing Theme’s Files