Publish to the catalog
List your tool publicly so any Vendo tenant can deploy it from the catalog.
Publishing puts your tool on the Vendo catalog. Any tenant browsing vendo.run sees the listing, runs through your wizard, and gets a managed deployment — billed in credits, isolated from every other tenant, upgraded when you ship new versions. You author one template manifest, submit it as a PR against vendo-templates, and Vendo handles the rest.
What you're publishing
Three things, in three places:
- A catalog entry in
apps_catalog(slug, name, type, marketing copy, pricing model). Created by a DB seed migration in the Vendo monorepo. - A template manifest in
runvendo/vendo-templates(services, databases, secrets, integrations, wizard layout). The file the deploy worker reads to provision a tenant's instance. - A release row in
tool_releasespointing at the manifest version. The pairing of catalog entry + active release is what makes a tool deployable.
The catalog entry is created once. Manifests and releases are versioned and replaceable.
The submission flow at a glance
- Build and verify the tool locally (Run locally as OSS).
- Author the template manifest (Manifest format).
- Define the deploy wizard (Wizard layout).
- Submit a PR against
runvendo/vendo-templates(Submission). - Ship updates as new versions (Versioning & releases).
- Manage tenant upgrades and rollouts (Rollout & upgrades).
Read these in order
The vendo-templates repo
Structure, layout, and how the action validates submissions.
Manifest format
Every field of the template JSON, with examples.
Wizard layout
Design the configure-step UX tenants see at deploy time.
Submission
Opening the PR and what review looks like.
Versioning & releases
How new versions get registered and which version a deployment is pinned to.
Rollout & upgrades
What happens to existing tenants when you ship a new version.
Where it fits in the bigger picture
The manifest references the SDK and integration declarations you authored in Build a tool. Publishing is the bridge between "I wrote a tool" and "any tenant can deploy it." Operating the deployed tool — logs, debugging, upgrades, suspend/resume — lives in Operate.