Promote
Moving forward is the unit of work in Caddi. dev → staging when a feature is ready to demo. staging → production when it’s signed off.
From the CLI
Full reference: caddi promote.
From the dashboard
On the project page, click Promote. You’ll see the diff of pending commits between source and target, a generated change summary you can edit, and any gates that will fire.
What promotion actually is
- A GitHub PR from the source branch into the target branch.
- Caddi auto-fills the PR title and body using the commits since the last promotion. You can override before submit.
- If the repo requires reviews via branch protection, the PR waits — Caddi watches and merges once reviews are green.
- On Pro projects with a client-approval gate, the PR also waits for the client’s thumbs up in the portal.
- The resulting deploy is watched until it’s ready or failed.
We never merge directly. Even if your branch protection is off, Caddi opens a PR — the audit log entry references it, and the diff is easier to recover later.
If the deploy fails
The promotion is still merged (because the PR went through GitHub). Caddi marks the environment as deploy-failed, links the Vercel build log, and surfaces the Revert action. See Revert.