How SuiteCommerce Advanced Combines Source Files Efficiently

The SuiteCommerce Advanced (SCA) source code is designed with modular organization across multiple subdirectories containing files such as JavaScript, Sass, and, for versions 2019.2 and later, TypeScript files identifiable by the .ts extension. This logical structure enhances readability but creates inefficiencies in network performance when files are individually transmitted to a web browser.

To optimize loading times, SuiteCommerce Advanced employs Gulp.js to carry out several tasks:

• File Inclusion: Identifies which files are necessary for the web application.
• File Combination: Merges JavaScript, Sass, and SSP library files into single combined files.
• Resource Copying: Transfers additional resources, such as images and SSP files, essential for application functionality.

All combined resources, along with any copied files, are stored in the Distribution directory, which is then deployed to NetSuite. For more details, refer to the output generated by the gulp tasks.

Related Topics

• SCA Build Process
• The distro.json and ns.package.json Files
• Contents of the Deploy and Local Distribution Directories

Using Gulp commands, developers can create deploy directories suited to their implementation:

• Deploy Command:
  • For SCA 2019.2 and later, it generates DeployDistributionAdvanced and DeployDistributionAdvancedSS2 directories.
  • For SCA 2019.1 or earlier, it generates the DeployDistribution directory.
• Local Command:
  • For SCA 2019.2 and later, it results in the LocalDistibutionAdvanced directory.
  • For SCA 2019.1 or earlier, it creates the LocalDistribution directory.

It is crucial not to directly modify any files in the deploy or local distribution directories, although their contents may be reviewed for troubleshooting purposes.