App Platform · Auto-deploy
Docs / App Platform

Auto-deploy

Ship automatically on every git push by turning on auto-deploy for the project.

With auto-deploy enabled, every push to your project's deploy branch triggers a fresh build and a zero-downtime rollout — no manual redeploy required.

How it works

Turning on auto-deploy connects the project to your GitHub repository so pushes are noticed automatically. When you push to the deploy branch, NevTan queues a deployment for you.

Enable and disable

  1. 1
    Open Auto-Deploy Settings
    From the project's action bar, click Auto-deploy. The Auto-Deploy toggle is disabled (with a tooltip) if GitHub isn't connected yet — connect it first.
    Auto-Deploy Settings modal with the toggle off
    Off by default — one toggle turns it on.
  2. 2
    Switch the toggle on
    NevTan tries to register a GitHub webhook automatically. When it succeeds, you'll see a box reading "Watching branch: <branch>" and a status line confirming the webhook is registered on GitHub.
    Auto-Deploy Settings modal with the toggle on and connection details
    Enabled — connection details shown, if you need to add them by hand.
  3. 3
    If automatic setup fails, add the webhook by hand
    An amber "Manual GitHub Webhook Setup Required" panel appears with a Payload URL and a Secret, each with a copy button — add these as a webhook in your GitHub repo settings yourself.
  4. 4
    Push to deploy
    Every push to the watched branch now triggers a build and a zero-downtime rollout automatically. Close the dialog — there's no separate Save button, the toggle takes effect immediately.
Note
Auto-deploy relies on your GitHub connection. If deploys stop triggering, confirm the repo is still connected — see GitHub integration.