Push to deploy

Every app deploys automatically when you push to its configured branch. It's on by default - the workflow is just git push.

How it works

Pyvolt's GitHub App subscribes to push events for the repositories you've granted it. When a push lands:

  1. Pyvolt matches the repository and branch against your apps. A push to develop doesn't deploy an app tracking main.
  2. Each matching app gets a deployment, shown in the deploy list as triggered via push, with the commit SHA and message.
  3. If that app already has a deploy queued or running, the push is skipped - two concurrent deploys would race on the same checkout. The next push after it finishes deploys normally.

Branch deletions and tag pushes never trigger deploys.

Turning it off

Per app: Settings → Deployment → Push to deploy. With it off, only the Deploy button deploys - useful when you want explicit control over production timing.

Manual deploys still work

The Deploy button is always there, whatever the toggle says. Manual deploys record you as the trigger; pushes record "via push".

View this page as markdown - handy as context for your AI tools. Full index at /llms.txt.