This guide walks you through connecting your Bilt project to GitHub for version control.Documentation Index
Fetch the complete documentation index at: https://bilt.me/docs/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
- A Bilt project
- A GitHub account
Step 1: Open GitHub settings
Go to your project → Settings → GitHub tab.Step 2: Authenticate with GitHub
Click Connect GitHub. You’ll be redirected to GitHub to authorize the Bilt GitHub App.Bilt uses a GitHub App (not a personal access token) for secure, scoped access to your repositories.
Step 3: Install the Bilt GitHub App
After authorizing, install the Bilt GitHub App on your account or organization. Choose which repositories Bilt can access:- All repositories — Bilt can connect to any of your repos
- Selected repositories — Limit access to specific repos
Step 4: Link a repository
Back in Bilt, select:- An existing repository to push code to
- Or let Bilt create a new one for this project
| Type | Best for |
|---|---|
| Mirror | Automatic one-way sync — Bilt pushes every change to GitHub |
| Webapp source | Two-way connection for teams working in both Bilt and GitHub |
Step 5: Verify
Once connected, your project code will appear in the linked GitHub repo. Each time the AI makes changes, the code is synced automatically. Check the repo on GitHub to confirm commits are appearing.Working with your code on GitHub
Once connected:- Clone locally —
git clonethe repo and work in your editor - Create branches — Use feature branches for experiments
- Set up CI/CD — Add GitHub Actions for testing or deployment
- Add collaborators — Invite your team to the repo
Disconnecting
Go to Settings → GitHub and click Disconnect. Your code stays in both Bilt and GitHub — nothing is deleted.Further reading
- GitHub Integration feature — Feature overview
- Code Export — Working with exported code