Migration Guide

How to Export a Bolt Project to GitHub

Step-by-step guide to connect your Bolt project to a GitHub repository for version control.

Feature1 Team · April 4, 2026 · 4 min read

Export Steps

1
Open your Bolt project

Navigate to the project you want to export. Make sure it builds without errors.

2
Click the GitHub icon

Click the GitHub icon in the top-right of your screen. A "Create a repository" window appears.

3
Create the repository

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.

4
Return to Bolt

Click Start building to return to your project. Bolt is now connected and will auto-sync with GitHub.

5
Verify on 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 .gitignore to 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.

Ready to ship production features?

Connect your GitHub repository to Feature1 and deliver features with AI-powered planning and implementation.

Join the Waitlist