convex-ship

Deploys a Convex backend and publishes the web build to a live convex.app URL.

9.4k|1.5k|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/openclaw/clawhub --skill convex-ship
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-ship
Source: https://github.com/openclaw/clawhub/tree/main/.agents/skills/convex-ship
Command: npx skills add https://github.com/openclaw/clawhub --skill convex-ship

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Moving a local Convex project to a live, shareable URL involves multiple manual steps: claiming anonymous deployments, deploying the backend, building the web app, and uploading the static bundle. This Skill orchestrates that entire publish workflow into one guided process.

Core Features & Use Cases

  • Backend Deployment: Claims or persists anonymous deployments and runs convex deploy to push the backend to the cloud.
  • Web Publishing: Builds the web app as a static export and uploads it through the moderated publish gateway, returning a *.convex.app URL.
  • Custom Domain Guidance: After publishing, offers next steps for custom domains via the domains or labs-acquire-domain flows.
  • Use Case: You have finished a Convex app locally and want a public link to share with teammates. Invoke this Skill to deploy the backend, publish the frontend, and receive the live URL in one flow.

Quick Start

Publish my current Convex app to a live convex.app URL and give me the link.

Frequently Asked Questions about convex-ship

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a Convex app to a live URL?

Run the ship workflow: it claims or persists your deployment, runs convex deploy for the backend, builds the web app as a static export, and uploads it through the publish gateway. You receive a live *.convex.app URL at the end.

How to publish a Convex web app to convex.app?

Build the web app as a static export and upload it via the moderated publish gateway, which returns the *.convex.app URL. The Skill handles this after the backend is deployed with convex deploy.

What happens with an anonymous Convex deployment when publishing?

If the project is on an anonymous deployment, the workflow first claims and persists it to the cloud through a Tier-2 sign-in. Only after that does it proceed with the backend deploy and web publish.

Can I use a custom domain instead of a convex.app URL?

Yes. After a successful publish, the Skill offers custom domain options: use the domains flow if you already own a domain, or labs-acquire-domain to find and buy one.

Does the agent hold the deploy key when publishing Convex apps?

No. Publishing is a privileged action that runs through the control plane after a moderation gate. The agent never holds the deploy key, and it confirms with you before producing a public URL.