Set Up Theme Developer Tools

This topic applies to

Applies to

SuiteCommerce | SuiteCommerce Advanced


Before you can create a theme, you must download the theme developer tools and extract them to create a top-level development workspace. This is where you maintain a theme’s HTML, Sass, and asset files. You use the developer tools to run Gulp.js commands to fetch files from the server, test your changes locally, and deploy themes to NetSuite.


You can only develop one theme per top-level theme workspace. To develop two or more themes simultaneously, you must set up multiple instances of the theme developer tools, one for each theme.


These tools are required for all SuiteCommerce sites and any SCA sites implementing the Aconcagua release or later. You cannot customize your SCA site’s Sass or HTML template files without these tools.

To download and extract theme developer tools:

  1. Login to your NetSuite account.

  2. In NetSuite, go to Documents > Files > File Cabinet.

  3. Navigate to SuiteBundles/Bundle 317001/.

  4. Download the .zip file you find there: (where x equals the latest minor release).

  5. Extract the .zip file to a location in your local environment. This becomes your root development directory for custom themes.

    The .zip file extracts into a directory named ThemeDevelopmentTools-20.1.x by default (where x equals the latest minor release). However, you can rename this directory to suit your needs.


    SuiteCommerce Advanced 2018.2 Developers: If you are implementing the 2018.2 release of SCA, you must use the 2018.2 developer tools when creating themes and extensions due to non-backward compatibility. The latest release of the SuiteCommerce Extension Management Bundle also includes the theme and extension developer tools for 2018.2.


    Do not move, delete, or rename any files or folders within the top-level development directory.

  6. Open a command line or terminal window.

  7. Access your root development directory created previously.

  8. Enter the following command to install additional Node.js packages into this directory:

    npm install


    This command installs the dependencies required to manage your custom themes. These files are stored in the node_modules subdirectory of the root development directory. This command may take several minutes to complete.

You are now ready to begin theme development. See Theme Developer Tools for information on fetching an active theme, testing on a local server, and deploying to a NetSuite account. For information on developing a theme, see Themes.

If you also intend to build extensions, you must Set Up Extension Developer Tools.