> ## Documentation Index
> Fetch the complete documentation index at: https://docs.architect.new/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting Your GitHub

> Push your Architect-generated app straight to your own GitHub repository and keep it in sync as you iterate.

## Why Connect GitHub?

Architect isn't a walled garden. If you connect your GitHub account, the full source code of any app you build can be pushed into a repository you own — so you can clone it, run it locally, collaborate with your team, or deploy it wherever you want.

## How to Connect

Inside any app you've built, click the **GitHub icon in the top-right corner** of the app view, then authenticate with your GitHub account.

<Frame>
  <img src="https://mintcdn.com/lyzr-636197f6/VOZPONDAmwlkiGTh/images/github/github_icon.png?fit=max&auto=format&n=VOZPONDAmwlkiGTh&q=85&s=c90f02d6a18d73914e9c1a41c28dcf4a" alt="GitHub icon in the top-right corner of the Architect app view" width="2940" height="1666" data-path="images/github/github_icon.png" />
</Frame>

After signing in, GitHub will ask you to **authorize Lyzr Architect** to access your account. Approve the request to grant Architect permission to create and push to repositories on your behalf.

<Frame>
  <img src="https://mintcdn.com/lyzr-636197f6/ovfCHnLxUzSFcJMI/images/github-authorize.png?fit=max&auto=format&n=ovfCHnLxUzSFcJMI&q=85&s=c7a4446f30b088e32c61334f76f7c4a7" alt="GitHub authorization screen granting Lyzr Architect access" width="2940" height="1590" data-path="images/github-authorize.png" />
</Frame>

Once authorized, Architect creates a repository for your app and pushes the initial codebase to your account.

## Automatic Commits on Every Change

After GitHub is connected, you don't need to manually sync anything. Every change you make in Architect — whether it's refining an agent, tweaking the UI, or updating a prompt — is automatically pushed to your repository as a new commit.

<Info>
  This means your GitHub repo always mirrors the latest state of your app in Architect, giving you a full version history out of the box.
</Info>

## Pull, Push & Branch Switching

Once your app is connected to GitHub, you get manual **Pull** and **Push** controls alongside the auto-commit flow — so you can explicitly sync code in either direction whenever you need to.

<Frame>
  <img src="https://mintcdn.com/lyzr-636197f6/W3si6aCCVL82xfhU/images/github/github_feat.png?fit=max&auto=format&n=W3si6aCCVL82xfhU&q=85&s=2226ef31d3867f7d83556267c1e70a53" alt="Pull, Push and branch switcher controls in the Architect GitHub panel" width="2936" height="1672" data-path="images/github/github_feat.png" />
</Frame>

**Switching branches.** Architect supports working across multiple branches of the same repository. To switch to a different branch:

1. Create the branch locally in your repo and push it to GitHub.
2. Open the GitHub panel in Architect and select the branch from the branch switcher.
3. Architect pulls the latest code from that branch into the sandbox and continues building from there.

This means you can maintain separate branches for different features or experiments, switch between them in Architect, and keep each one in sync independently — just make sure the branch exists on GitHub before switching.