GitHub Integration

Bilt connects to GitHub so your app’s source code lives in your own repository. Bilt mirrors your project to a GitHub repository and keeps the two in sync as you build. You manage everything from Settings → GitHub in your project.

What it is

GitHub integration mirrors your Bilt project to a repository in your GitHub account or organization. Your app’s source code lives in a real repo with version history — not just inside Bilt — so you can clone it, share it with others, and use the same Git workflows you would on any other project. Bilt keeps the repository updated as you build.

What you can do

Mirror to GitHub — Bilt copies your project to a GitHub repository in the account you choose
Two-way sync — Changes you make in Bilt or on GitHub are kept in sync automatically
Own your code — Clone the repo, work locally, and continue in any editor
Collaborate — Add team members and wire up GitHub Actions or other tooling

How it’s organized

The GitHub settings have two tabs:

Tab	What it’s for
Accounts	Connect or disconnect the GitHub accounts and organizations Bilt can access
Repository	Sync your project to a GitHub repo, resync it, or unlink it

Working with your code on GitHub

Once your code is on GitHub, you can:

Clone and continue development locally
Set up CI/CD pipelines with GitHub Actions
Add team members as collaborators
Open the project in any editor or IDE

See Code Export for more on working with your code outside Bilt.

Two kinds of GitHub connection

A project can link GitHub repositories in two different ways. They use the same connected accounts but behave very differently:

	Repository sync	Web app source (Web App Sync)
What the repo holds	Your Bilt project’s own code	An existing web app you built elsewhere
Where you set it up	Settings → GitHub → Repository	Settings → Convert Website
Direction	Two-way	One-way, into Bilt only
Bilt pushes to it	Yes — every change you make in Bilt	Never
Pushing to it from GitHub	Pulls your commits back into the project	Re-clones the repo into the sandbox
Where it lands	Into your repository in GitHub	Sits next to your project in the sandbox, as a read-only reference
How many	One repo per project	One repo per project

In short: repository sync is where your app lives; web app source is something the agent reads to build your app. A project can have both at once — mirror your mobile app to your own repo while the agent references the web app it’s based on.

Guide

For a step-by-step walkthrough, see the connect GitHub guide.

​What it is

​What you can do

​How it’s organized

​Working with your code on GitHub

​Two kinds of GitHub connection

​Guide