Deploy from Git

Deploy from Git connects a StackMachine app to a GitHub repository so source control becomes the deployment control plane. Choose the app, repository, and branch once; then keep releases tied to reviewed commits instead of manual uploads.

Features

Branch-based deploys

Connect a repository installation to an app and choose the branch StackMachine should build from. The connection stores the selected branch and source repository with the app.

Status events and pull request comments

Enable deployment status events and pull request comments when you want repository activity to show whether a StackMachine deploy is healthy.

Auditable source history

Git deploys make every release traceable to the commit, branch, and repository that produced it. That is useful for production rollbacks, review, and support investigations.

Common workflow

Deploy or retrieve the StackMachine app you want to connect.
Install the StackMachine GitHub app for the target repository and capture the installation repository ID.
Call client.apps.git.connect with the app ID, installation repository ID, and deploy branch.
Use client.apps.git.update when you need to change the branch, deployment status events, or pull request comments.

SDK examples

Connect a repository

Connect an app to a GitHub installation repository and select the branch that should deploy.

manageAppGitConnection.js

const appId = "da_XYZ";

const connection = await client.apps.git.connect({

app: appId,

installationRepoId: "github_repo_installation_id",

deployBranch: "main",

});

// Should return: {// { ... }

console.log(connection.id, connection.deployBranch);

console.log(connection.githubRepoInstallation.repoUrl);

Tune deploy feedback

Update the connection after it exists. Retrieve it when you need to show current branch and connection metadata.