Connect your GitHub repo (build on push)
Link a repository so every push builds automatically — no manual uploads.
1. Install the BuildStack GitHub App
From a project's Repository settings, start the connect flow. It sends you to GitHub to install the BuildStack App on the account (org or user) that owns your repo, and to pick which repositories it can access.
2. Map the repo to a project
Back in BuildStack, choose the repository and the project it should build. You can map different repos to different projects in the same workspace.
3. Configure the trigger
- Branches — build all pushes, or filter to specific branches (for example
main, release/*).
- Build config — the platform, variant, and format each push should produce.
How it runs
On a matching push, GitHub notifies BuildStack, which pulls the commit, builds it on managed compute, and signs it with the project's credentials. Watch progress on the project's Builds list.
Reconnecting
If you reinstall or recreate the GitHub App, its installation id changes and the old link goes stale. Re-run the connect flow (or use Reconnect where offered) to point the workspace at the current installation.
Related
- Run GitHub Actions CI on BuildStack — for running your own
workflow steps, not just app builds.