Product delivery
Create products
Package resources and publish versions.
Create a product
In Marketplace > Products, choose New product. Give it a name, an optional description, a first version (default 1.0.0) and the resource RIDs to package. The first version is published at once.
Converge checks that every resource exists, is not in the trash and that you can read it. A product can only package what its publisher can open, so it cannot carry someone else's restricted resource into other projects.
Publish a new version
Open the product card, choose Details, then New version. The version field suggests the next patch number; a new version must be higher than the latest one.
A version can carry:
- Resource RIDs: extra resources to package. With folder tracking on, the tracked folder's outputs are added automatically. Everything packaged, including tracked outputs and overrides, must be readable by you.
- Changelog: what changed, shown in the version history.
- Release channel:
stable(default),betaordev. See Channels, lock and rollback. - Linked products: upstream products this version needs. See Linked products.
- Store tags: tags for browsing. See Store permissions and tags.
- Input presets: values installers pick for the packaged apps' inputs. See Input presets.
Details lists every version with its channel, resource count, date, linked products, inputs and changelog.
Folder tracking
Instead of listing resources by hand, a product can track a source folder. Every new version then packages the folder's current contents, minus ignored subfolders, plus resources added manually and per-resource overrides. In strict mode every output must come from the tracked folder. Open it from the product card's More > Folder tracking. You can only track a folder, or override a resource, that you can read.
API
| Method | Path | Requires |
|---|---|---|
| POST | /api/v2/products | product:write |
| GET | /api/v2/products | product:read |
| GET | /api/v2/products/{id} | product:read |
| POST | /api/v2/products/{id}/versions | product:write |
| GET, PUT, DELETE | /api/v2/products/{id}/folder-tracking | product:read / product:write |