Custom Theme Development Tools for SuiteCommerce

The SuiteCommerce theme developer tools enable you to customize existing themes and create new ones efficiently. This tool supports two primary methods of theme creation: via the create command, which offers a fallback theme approach for easy updates, and by fetching active theme files as a baseline for your custom theme.

How Can You Create a Custom Theme?

There are two distinct ways to initiate the creation of a custom theme:

1. Using the create Command

This method is preferred for creating themes as it allows for automatic updates. When you use the create command, your new theme inherits files from the Base Theme, establishing a foundational structure for further customization. Your custom theme can easily receive updates and new features from the Base Theme—just reactivate the theme to benefit from enhancements.

Important Notes:

• You cannot introduce new templates or Sass files within the custom theme. Instead, modifications should be made to existing files or added through extensions.
• The assets folder operates as an all-or-nothing approach. You must either use all assets from the Base Theme or exclusively from your custom theme. Specifying an assets entry in the manifest.json of your custom theme dictates which assets folder will be utilized.

2. Fetching Active Theme Files

This method allows you to download files from any published theme or previously deployed custom theme. It serves as a foundation for your new theme, providing access to development files that can be modified as needed. However, be cautious: fetching a theme will overwrite any existing theme files in your local workspace, potentially leading to data loss.

Prerequisites:
Before creating a custom theme, ensure you have:

• Set up your Theme Developer Tools.
• Installed the Base Theme (activation is not required).

Summary of Steps to Create a Custom Theme

To create a custom theme:

1. Open your terminal or command line interface.
2. Use the appropriate command (gulp theme:create for the create command or gulp theme:fetch for fetching files) based on your chosen method.
3. Configure and customize your theme folders and files to meet your specific needs.

By leveraging these methods, you can effectively develop and manage custom themes tailored to your eCommerce needs.