> ## 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.

# Connect GitHub

> Push your Bilt app code to a GitHub repository

This guide walks you through connecting your Bilt project to GitHub for version control. Bilt mirrors your project to a GitHub repository and keeps both sides in sync.

## Prerequisites

* A Bilt project
* A [GitHub](https://github.com) account

## Step 1: Open GitHub settings

Go to your project → **Settings → GitHub**. You'll see two tabs: **Accounts** and **Repository**.

## Step 2: Connect a GitHub account

On the **Accounts** tab, click **Connect GitHub account**. A popup opens GitHub, where you authorize and install the Bilt GitHub App on your personal account or organization.

<Frame>
  <img src="https://mintcdn.com/buildingppou/Eg5vvKqxHX5gf36V/images/connectGithub1.png?fit=max&auto=format&n=Eg5vvKqxHX5gf36V&q=85&s=c3f627d7494dc73c2a90db39afcc9c05" alt="The GitHub Accounts tab with the Connect GitHub account button" width="1471" height="826" data-path="images/connectGithub1.png" />
</Frame>

When prompted to choose repository access:

* **All repositories** — recommended for the smoothest experience
* **Selected repositories** — limit Bilt to specific repos

<Frame>
  <img src="https://mintcdn.com/buildingppou/Eg5vvKqxHX5gf36V/images/connectGithub2.png?fit=max&auto=format&n=Eg5vvKqxHX5gf36V&q=85&s=e86bbd6fdf112964680a0c0cd2e70216" alt="GitHub's Install & Authorize page with repository access options" width="646" height="820" data-path="images/connectGithub2.png" />
</Frame>

<Info>
  Bilt uses a GitHub App for secure, scoped access. Connected accounts appear on the **Accounts** tab.
</Info>

<Frame>
  <img src="https://mintcdn.com/buildingppou/Eg5vvKqxHX5gf36V/images/connectGithub3.png?fit=max&auto=format&n=Eg5vvKqxHX5gf36V&q=85&s=dcf0f48b88226f0fd93f8143017ece04" alt="A connected GitHub account on the Accounts tab" width="1381" height="521" data-path="images/connectGithub3.png" />
</Frame>

## Step 3: Sync your project to a repository

Switch to the **Repository** tab and click **Sync to GitHub**. Choose the GitHub account to use, then confirm. Bilt creates a new repository in that account and mirrors your project to it.

<Check>
  Once the sync finishes, the repository URL appears on the Repository tab. Open it on GitHub to confirm your code is there.
</Check>

## Step 4: Keep it in sync

After the first sync:

* Changes in Bilt and changes on GitHub are kept in sync automatically
* Click **Resync to GitHub** on the Repository tab any time you want to push the latest changes manually

## Working with your code on GitHub

* **Clone locally** — `git clone` the 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

## Further reading

* [GitHub Integration feature](/docs/features/github-integration) — Feature overview
* [Code Export](/docs/features/code-export) — Working with exported code