- Handles Git automatically: Bolt manages the technical Git steps for you.
- Gives you control: You decide which projects connect to GitHub.
- For GitHub orgs, gives admins control: Admins can decide which organization repos are available to which organization accounts.
Bolt also offers a GitHub MCP connector for tasks like searching code, pulling in issues, and reviewing discussions. Use the GitHub integration described in this article to keep your project’s code synced with a repository. Use the MCP connector for other GitHub workflows that don’t involve syncing commits.
Prerequisites
To connect your GitHub account to Bolt, you need an individual GitHub account. Before starting, sign up for a GitHub account if you don’t already have one.If your GitHub organization is connected to Bolt, you can access organization repositories through your org instead. See GitHub organization setup for details.
Connect GitHub
To connect an individual GitHub account to Bolt:- Sign in to Bolt and open a project.
- In the top-right corner of the screen, click the GitHub icon.
- Click Log in to GitHub.
- When prompted to let StackBlitz (Bolt’s parent company) access your GitHub account, click Authorize.
- Click Install the GitHub App.
- Select whether Bolt can access All repositories or Only select repositories. The Install & Authorize Bolt.new (by StackBlitz) page opens.
- Click Install & Authorize to confirm, then follow the on-screen instructions to enter your credentials.
Change repository access
If you want Bolt to access additional repositories, or remove access to ones it no longer needs, you can update this at any time. You don’t need to be an organization admin to do this for your own account.- In Bolt, open a project connected to GitHub.
- In the top-right corner of the screen, click the GitHub icon.
- Click Configure the GitHub App. The Install & Authorize Bolt.new (by StackBlitz) page opens.
- Update your repository access, then click Save.
Create a new repository from a Bolt project
- Open the project you want to link with a new GitHub repository.
- In the top-right corner of the screen, click the GitHub icon. The Create a repository page opens.
- Enter a name for your new repository.
- Click Create repository.
- Click Start building to return to Bolt.
Import an existing repository
You can import a repository if you have push permissions on it and it has a default branch. You can’t import a repository that’s empty.
- On the Bolt homepage, below the chatbox, click GitHub, then log in to your GitHub account.
-
Choose how you want to import:
- Use the drop-down menu to select the repository.
- Click Import from URL, then enter your GitHub repository URL.
- Click Choose this repository. Bolt loads your repository as a new Bolt project.
Work with branches
When you create or import a repository in Bolt, your project starts on themain branch. This is usually the live version of your project. You can do all your work on main, or create branches.
Branches let you:
- Work with others without overwriting each other’s changes.
- Work on different features separately, so unfinished work doesn’t go live.
For example, if you’re building three new features on the
main branch, you’d have to finish all three before publishing. With branches, you can finish and merge each one into main as it’s ready.main. This keeps work isolated, reduces the chance of merge conflicts, and makes changes easier to review. When your changes are ready, open a pull request in GitHub to merge them.
Create a branch
- Open a project that’s already linked to a GitHub repository.
- In the top-right corner of the screen, click the GitHub icon.

- Click Create branch. The Add a branch window opens.
- Enter a name for your branch. The new branch starts from the branch your project is currently on.
- Click Create branch.
You’re now working on your new branch, which Bolt also creates in your GitHub repository.
Switch branches
- Open a project that’s already linked to a GitHub repository.
- In the top-right corner of the screen, click the GitHub icon.
- Under
Switch branch, click the branch you want to work on.
Merge branches
You can’t merge branches in Bolt. To merge a branch, open a pull request in GitHub. To learn how, see GitHub’s steps for Creating a pull request.How Bolt syncs with GitHub
Bolt saves your work automatically. Every time you make a change that doesn’t break the project, Bolt creates a commit for you. It also checks GitHub every 30 seconds for any updates made outside Bolt and pulls those in.Resolve conflicting changes
Rarely, GitHub might have a newer version than Bolt. This can happen if a change is pushed to GitHub while you’re making changes in Bolt. If this happens, Bolt can’t push your latest changes, and a GitHub conflict message appears. Bolt pulls in the newer GitHub version, and you choose one of these options:- Pull and resend last message: Apply the last change you made in Bolt again on top of the new GitHub version.
- Pull and discard last message: Keep GitHub’s version as-is, without applying the last change you made in Bolt.
Check your sync status
To check your connection and sync status, go to the top-right corner of the screen and click the GitHub icon. TheGitHub status panel shows:
- The sync status, at the top of the panel.
- The linked repository.
- The branch your project is on, marked with a checkmark under
Switch branch. - Options to create or switch branches, open the repository on GitHub, read about GitHub sync, and disconnect the repository.
Couldn't sync with GitHub message also appears.
What does my sync status mean?
If GitHub has newer changes than your Bolt project, a GitHub conflict message appears instead. To learn more, see Resolve conflicting changes.
If the panel says
Synced to GitHub but a recent change isn’t in your repository, try reauthorizing your GitHub connection using the instructions in the next section.
Troubleshoot GitHub sync issues
In your own projects, Bolt syncs to GitHub every time you make a change. If collaborators edit your project, their changes sync the next time you open the project. If your changes don’t sync to GitHub as expected, reauthorizing the GitHub app can help refresh the connection and get your sync working again. To reauthorize your GitHub connection:- On the Bolt homepage, below the chatbox, click the GitHub option.
- In the Import a repository dialog, click Configure the GitHub App. The Install Bolt.new (by StackBlitz) page opens.
- Select your GitHub account. The Install & Authorize Bolt.new (by StackBlitz) page opens.
- Click Install & Authorize, then follow the on-screen instructions to enter your credentials. When GitHub finishes verifying your credentials, you’re returned to Bolt, and your connection is refreshed.
Connect to a GitHub organization
Bolt supports working with GitHub organizations, which allow teams to install the Bolt app at the organizational level and choose which repositories are visible to members inside Bolt. To learn more, see GitHub organization setup.Collaborate on projects connected to GitHub
Only the project owner can connect and manage the GitHub integration. If you’re a collaborator on a shared project, the GitHub icon isn’t available to you, and changes you make sync to GitHub the next time the project owner opens the project. To learn more about how integrations work in shared projects, see Collaborate with others.Disconnect a project from its repository
Disconnecting a project permanently removes its connection to the GitHub repository. The project no longer syncs to GitHub, and you can’t manually reconnect it. To disconnect a project:- Open a project that’s already linked to a GitHub repository.
- In the top-right corner of the screen, click the GitHub icon.
- Click Disconnect repository, then click Disconnect to confirm.
If you need to reconnect the project to the same GitHub repository, contact support.
Disconnect GitHub
Fully removing your GitHub integration is a one-step process if you used your GitHub account to create your Bolt account, or a two-step process if you didn’t. Either way, start by following the steps below:1
Revoke access in GitHub
- Log in to GitHub.
- In the top-right corner of the screen, click your profile icon.
- Click Settings.
- In the left-side navigation menu (near the bottom), click Applications.
- Click the Authorized GitHub Apps tab.
- In the Bolt/StackBlitz row, click Revoke.
- Click I understand, revoke access.
If you signed up for your StackBlitz/Bolt account using Google or your email address, continue to part 2 to complete the process. If you signed up using GitHub, your GitHub integration is now removed.
2
Delete the GitHub connection in StackBlitz
- Log in to StackBlitz.
- In the left navigation menu, click Settings.
- Click the Credentials tab.
- In the GitHub section, click Delete.