Set Up Theme Developer Tools

This topic applies to

Applies to

SuiteCommerce Web Stores | Aconcagua

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 248721/.

  4. Download the .zip file you find there:

  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-18.2.1 by default, but you can rename this directory to suit your needs.


    SuiteCommerce theme and extension developers must use the SuiteCommerce Extension Management Bundle 2018.2.1 release to create themes and extensions for SuiteCommerce and the 2019.1 release of SuiteCommerce Advanced. Refer to the Commerce Applications for more information on next steps.

  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.

  9. If you are implementing the 2019.1 release of SuiteCommerce Advanced and you want to use the theme and extension developer tools, follow instructions in Set Up SCA 2019.1 for Theme and Extension Developer Tools.

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.