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.

Important

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.


Note

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:

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

    Important

    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

    Note

    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.