How to Export a Bolt Project to GitHub
Step-by-step guide to connect your Bolt project to a GitHub repository for version control.
Export Steps
Navigate to the project you want to export. Make sure it builds without errors.
Click the GitHub icon in the top-right of your screen. A "Create a repository" window appears.
Enter a repository name and click Create repository. Authorise GitHub access for StackBlitz/Bolt if prompted. The repository is created as private on the main branch.
Click Start building to return to your project. Bolt is now connected and will auto-sync with GitHub.
Open GitHub and confirm that your repository exists with the correct files, default branch, and no committed secrets.
Auto-Sync Behaviour
- Bolt auto-commits every change that does not break the project.
- Bolt checks GitHub every 30 seconds for updates made outside Bolt and pulls them in automatically.
- The repository is created as private by default. You can make it public through GitHub repository settings.
Post-Export Checklist
- Clone the repo locally and verify the project builds outside Bolt.
- Review
.gitignoreto make sure build artefacts and environment files are excluded. - Check that no API keys or secrets were committed in the initial push.
- If your team has multiple contributors, set up branch protection rules on
main.
Troubleshooting
- GitHub icon missing: Make sure you are on a paid Bolt plan that includes GitHub integration.
- Auth error: Re-authorise StackBlitz/Bolt in your GitHub account settings under Applications.
- Sync not working: Check that the Bolt GitHub app still has access to the repository in your GitHub settings.
Next Step
Export is done. To move from prototype to production delivery with structured planning and AI implementation: See how Feature1 works.
Verification
Verified on April 4, 2026. Source: Bolt Support (GitHub Integration). If UI labels differ, follow the current Bolt documentation.
Continue in Claude Code, Cursor, or any coding agent
Once the project is on GitHub, you are no longer tied to Bolt. Clone the repository to your machine and run your coding agent — Claude Code, Cursor, Codex — directly in the project folder. The agent now works on your real codebase with full git history, instead of inside the builder's sandbox. And when you want planned features instead of one-off prompts, Feature1 connects your repo so agents implement against approved acceptance criteria.
Frequently asked questions
Does Bolt keep syncing with GitHub after the export?
Yes. Once connected, Bolt auto-commits every change that does not break the project. It also checks GitHub every 30 seconds for changes made outside Bolt and pulls them in automatically. If sync stops working, check in your GitHub settings that the Bolt GitHub app still has access to the repository.
Is the repository Bolt creates public or private?
Bolt creates the repository as private, on the main branch. You can make it public later through the repository settings on GitHub. Before you do, check that no API keys or secrets were committed in the initial push, and review the .gitignore so build artefacts and environment files are left out.
Why is the GitHub icon missing in Bolt?
The GitHub integration needs a paid Bolt plan. If you do not see the GitHub icon in the top-right of your screen, check that your plan includes it. If the icon is there but you get an auth error, re-authorise StackBlitz/Bolt in your GitHub account settings under Applications.
More export guides
Ready to ship production features?
Connect your GitHub repository to Feature1 and deliver features with AI-powered planning and implementation.
Start your free trial