# Factorize Colorways — 5-minute setup

1. **Activate** the plugin (WooCommerce must be active). Factorize → Colorways appears under the Selling tab.
2. **See it work first:** Colorways → Examples → *Create the example catalog*. Twelve designs appear in the shop with swatches, placements, and generated mockups. Open one on your phone and on a desktop; tap swatches and placements.
3. **Attributes:** Products → Attributes. You need `Color` (used for variations); `Placement` and `Size` are optional. Give each color term a *Swatch color* (or rely on the built-in names: black, navy, heather-grey, …).
4. **Products:** create a *Variable* product, add the attributes ticked "Used for variations", generate variations (size can be *Any*), set prices. Optionally fill *Colorway image name* (e.g. `skyline`) and *Colorway image category* (e.g. `tee`).
5. **Files:** name mockups `{name}-{color}-{category}.svg` → `skyline-black-tee.svg`, plus `skyline-black-tee-back.svg` for placement views if you have them. Upload via Media → Add New, or FTP into `wp-content/uploads/colorways/` and press *Rescan* on the Coverage tab.
6. **Check:** Coverage tab — every row green. Missing names are listed verbatim; copy them into your export tool.
7. **Tune** the print-area boxes (Settings → Print areas) once to match your mockups; they are percentages of the image, so they hold on every screen size.

Already have a folder of mockups? Set the template to match the names (Settings), mount or upload the folder as the library, then Examples → *Import the catalog from the library* (or `wp colorways import`): products, variations, categories, and featured images come out of the file names.

Tip: no artwork yet? *Generate placeholder mockups* draws flat garments in each color so the store can launch and the files can be swapped later — same names, no other change.
