Table of Contents
Magento 2 Shirt Builder User Guide
Related overview
For a shopper-friendly overview of features and setup, see the Magento 2 Shirt Builder User Guide - Custom Apparel Wizard on the storefront. This wiki page remains the full technical documentation.
Extension context
This is a Toweringmedia Magento 2 extension guide for the current admin extension catalog.
Product page
- Magento 2 Shirt Builder (SKU
Magento 2 Shirt Builder)
Overview
Shirt Builder is the apparel flow pack for the Towering Media Product Builder framework. It adds a curated shirt configuration wizard where shoppers select style, color, size, and design options with live visual feedback, plus AI preview generation and legacy design resolution. It is intended for custom apparel brands, print shops, and promotional merchandise stores.
What this extension does
- Guided storefront wizard for shirt and sweatshirt configuration.
- Style, color, size, and design option selection with real-time visual feedback.
- AI-assisted preview generation for the configured garment.
- Legacy design resolution for previously saved customer designs.
- Hyvä-compatible storefront rendering.
Requirements
- Magento 2.4.x (Open Source or Adobe Commerce).
- PHP: ^8.2 || ^8.3 || ^8.4 (as declared by the published package).
- A current Toweringmedia license and Composer credentials for
https://composer.toweringmedia.com/. - Requires
toweringmedia/module-product-builder-coreandtoweringmedia/module-ai-core— Composer installs both automatically. - AI Core must be configured with a working provider before AI preview generation will work.
Installation
Install and validate in a staging environment before production rollout.
cd /path/to/magento composer require toweringmedia/module-shirt-builder bin/magento module:enable Toweringmedia_ShirtBuilder bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy -f bin/magento cache:flush
Currently published versions at the time of writing:
toweringmedia/module-shirt-builder— 0.3.3
Toweringmedia packages are served from the licensed Composer repository https://composer.toweringmedia.com/. If Composer reports that the package could not be found, your credentials are missing or the license does not cover this package yet. Retrieve your keys from My Account on toweringmedia.com, or contact support@toweringmedia.com.
General installation notes that apply to every Toweringmedia extension are in the installation guide.
Configuration
- Shirt Builder ships no configuration section of its own. Builder settings live in Stores > Configuration > Towering Media > Product Builder (config section
product_builder, provided by Product Builder Core). - Per-product wizard setup is done on the product record itself, not in Stores > Configuration.
Basic usage and what to expect
- Install and enable the module, then assign the shirt wizard flow to the apparel parent products that should use it.
- Open the product on the storefront and step through the wizard to confirm options, preview, and add-to-cart behave as expected.
Notes and limitations
- This is a flow pack, not a standalone builder. It is only useful alongside Product Builder Core.
- AI preview generation consumes AI Core provider budget.
Validation checklist
bin/magento module:statusshows the module(s) as enabled.- Extension configuration saves without errors in Admin.
- The admin screens listed above are reachable and load without error.
- Expected storefront/admin behavior is present after a cache flush.
- No critical PHP/JS errors appear in
var/log/during the primary test flow.
Troubleshooting
- Composer cannot find the package: confirm the
https://composer.toweringmedia.com/repository and your credentials are present inauth.json, and that your license covers this package. - Feature not visible: verify module status, flush cache, and redeploy static content.
- Admin setting not applying: clear cache and confirm the config scope (default / website / store view).
- Unexpected behavior: retest with only the required related modules enabled.
