A Chrome extension that automatically captures ZIP file downloads from bolt.new, extracts them, and pushes the contents to a specified GitHub repository. Built with Svelte, TypeScript, and TailwindCSS. Visit our official website at bolt2github.com for more information, tutorials, and resources.
What's new:
- Personal access token support has ended
- A Bolt2GitHub account and GitHub App connection are now required for GitHub features
- Existing repository and project mappings are preserved during the required migration
- Legacy credentials are removed locally and the extension shows the exact reconnection steps
- Onboarding now follows the live Bolt2GitHub session before GitHub App connection
- Download works from Bolt's current project dropdown, where the action now appears directly without an Export submenu
- Project-scoped repository settings keep the correct project mapping and preserve custom repository names
- Google Analytics event tracking is paused; no GA4 secret or Google Analytics host permission ships in the extension
- Release packaging now stops on failed builds and automated publication waits for unit, contract, build, and browser checks
How to migrate:
- Open the extension and select Connect GitHub Account
- Sign in to your Bolt2GitHub account
- Install or reconnect the GitHub App and choose the repositories it may access
- Return to the extension; your preserved repository mappings will be ready to use
This is an intentional product simplification after the GitHub App has been the recommended setup for more than a year. Historical standalone usage cannot be measured reliably, so this release does not make claims about how many people used the retired path.
What's new:
- New extension installs open only the welcome page instead of also opening automatic login tabs
- Empty sessions are treated as the expected onboarding state rather than an expired login
- Existing invalid or expired sessions still keep their guided recovery behavior
Key Benefits:
- Cleaner first-run experience with no duplicate, focus-stealing login tabs
- Sign-in starts from the welcome flow or another explicit user action
- Established authentication recovery remains available when a real session fails
What's new:
- Fixed a GitHub App retry loop that could repeatedly check incomplete connections in the background
- Incomplete GitHub App installation details no longer cause repeated background token checks
- Open Bolt tabs now receive refresh guidance before an authentication self-heal reload
- Successful pushes can show a lightweight suggestion for a relevant Pro feature
Key Benefits:
- Far fewer unnecessary background authentication requests
- Background authentication traffic remains bounded when installation details are incomplete
- Extension reload recovery is clearer on tabs that need a refresh
- Pro discovery happens after a successful push without interrupting the workflow
What's new:
- Clearer push errors with a retry option instead of failing silently
- More reliable auth recovery after stale sign-ins or extension reloads, without a manual disable/enable cycle
- GitHub App connections survive normal re-authentication instead of forcing a full reconnect
- Consistent repository name validation before a push can fail
- Reconnect notices on open Bolt tabs when an extension reload or update leaves the injected UI disconnected
Key Benefits:
- Push failures are actionable: you see what went wrong and can retry immediately
- Background auth recovery keeps working across MV3 service worker restarts
- GitHub App setup is preserved through transient session expiry
- Orphaned tabs tell you exactly when a page refresh is needed to reconnect
What's new:
- Restored the Push to GitHub button after Bolt moved the Share/Publish toolbar
- Toolbar detection now supports both legacy
ml-autolayouts and the current Publish/Share anchored layout - Added regression tests for the current May 2026 toolbar structure
Key Benefits:
- Push to GitHub appears again on current bolt.new project pages
- Cached or older Bolt tabs remain supported through legacy selector fallbacks
- Future toolbar changes are easier to diagnose with a dedicated fixture
What's new:
- Restored download/export flow after Bolt swapped the dropdown chevron from Lucide to Phosphor
- Icon-library agnostic selectors that work across Lucide, Phosphor, and Heroicons
- Regression tests pinned against the May 2026 Bolt DOM
- New
fix-bolt-selectorsrecovery skill and two-step DOM capture script
Key Benefits:
- Download button keeps working through Bolt's icon library reshuffles
- Future Bolt redesigns get fixed in minutes instead of hours
- Failing tests catch the next selector regression before it ships
What's new:
- Independent extension auth session decoupled from bolt2github.com
- Commits List Modal (Pro) with pagination and GitHub link
- Editable project title and repository name from repo settings
- Fixed inability to rename repository
Key Benefits:
- Auth no longer breaks when the website session rotates or expires
- Browse and audit your commit history without leaving the extension
- Rename projects and repos in place
What's new:
- Supabase refresh token 30-day expiration handling
- GitHub App token validation with Supabase token expiry checks
- Comprehensive auth lifecycle recovery for MV3 service worker
- Handles both 401 and 403 responses for expired tokens
- Chrome alarms API for periodic auth checks surviving service worker termination
- Sync-in-progress timeout auto-reset (5min) prevents stuck state
Key Benefits:
- No more persistent auth failures after inactivity
- No need to manually toggle the extension off/on to recover
- Proactive token validation before refresh attempts
- Robust auth state management across service worker restarts
What's new:
- Branch dropdown with auto-filtering in repo settings
- Fixed button injection for bolt.new's updated UI
- Dropdown toggle and updated button styling
Key Benefits:
- Select or create branches directly from the extension
- Seamless integration with bolt.new's latest design
- Cleaner UI with proper dropdown toggle behavior
What's new:
- Fixed Notification Spam – No more annoying notification spam when Bolt.new tabs are in the background
- Smart Rate Limiting – Notifications limited to once every 5 minutes to prevent overwhelming users
- Background Tab Detection – Extension detects when tabs are backgrounded and adjusts behavior accordingly
- Persistent Settings – Your notification preferences are saved and survive browser restarts
- Opt-in Reminders – Scheduled reminders disabled by default for a cleaner experience
Key Benefits:
- No More Notification Spam – Clean, distraction-free experience when working with background tabs
- Smart Rate Limiting – Prevents overwhelming users with too many notifications
- Persistent Preferences – Your settings are remembered across browser sessions
- Better Default Experience – Reminders are opt-in, reducing notification fatigue
What's new:
- Auto-Recovery from Auth Expiry – Extension automatically reloads to fix persistent authentication issues
- Manifest V3 Optimization – Reliable service worker reloads using chrome.alarms API instead of setTimeout
- Enhanced Stability – Persistent reload throttling prevents loops (5-minute minimum between reloads)
- Improved Testing – 30+ new tests ensure robust authentication recovery
Key Benefits:
- No More Manual Restarts – Automatically recovers from auth failures without user intervention
- Reliable in All Scenarios – Works even when service worker becomes inactive (Manifest V3 fix)
- Smart Self-Healing – Reloads only when necessary after 3 consecutive auth failures
What's new:
- Updated for New Bolt.new Design – Seamless integration with the latest UI changes
- Fixed GitHub Button Injection – Now works with the new header layout structure
- Enhanced Download Functionality – Updated to work with project name dropdown export flow
- Eliminated Color Flash – Button appears with correct styling immediately
- Improved Button Placement – Smart targeting of GitHub button container
Key Benefits:
- Seamless Integration – Works perfectly with Bolt.new's updated design
- Reliable Downloads – Export functionality works with the new dropdown structure
- Better UX – No more color flashing or visual glitches
- Future-Proof – Robust selectors that adapt to UI changes
What's new:
- Bolt.new Header Integration Fix – Updated to work with bolt.new's new header layout
- Enhanced Re-authentication Flow – Improved authentication handling and user guidance
- Export Button Detection Update – Fixed export/download functionality with new bolt.new structure
Key Benefits:
- Seamless Integration – GitHub button injection works perfectly with updated bolt.new header
- Reliable Downloads – Export → Download functionality restored and working reliably
- Better User Experience – Improved authentication flow with clearer guidance during token issues
- Future-Proof – Maintains backward compatibility while supporting new bolt.new features
What's new:
- Pop-out window mode – Keep the extension open in its own dedicated window that never closes when you click away.
What’s new:
- Works with Bolt’s new 3-dots Export menu – seamless Export → Download interception again.
- Lighter on resources – background observers use less CPU.
- More resilient – graceful errors and self-recovery if something goes wrong.
Major Features:
- Automatic README Generation - Smart documentation creation for projects without meaningful README files
- Smart Content Detection - Preserves existing documentation while replacing empty or whitespace-only files
- Zero Setup Required - Works automatically during push to GitHub with no configuration needed
Key Benefits:
- Never push undocumented projects - Automatic README creation ensures every project has meaningful documentation
- Intelligent detection - Handles README, readme, Readme file variations with case-insensitive detection
- Content preservation - Existing meaningful documentation is always preserved
- Project branding - Generated READMEs include project name and Bolt to GitHub attribution
Major Features:
- Automatic Project Sync - Your Bolt projects now sync automatically across devices and browsers
- Data Loss Prevention - Fixed critical race conditions that could cause project data loss
- Enhanced Reliability - Comprehensive improvements to storage operations and error handling
Key Benefits:
- Never lose your projects - Seamless synchronization ensures your project mappings are always available
- Cross-device compatibility - Access your projects from any browser or device
- Automatic conflict resolution - Smart handling of sync conflicts with multiple resolution strategies
- Background sync - Periodic 5-minute automatic syncing keeps everything up-to-date
Bug Fixes & Improvements:
- Enhanced bug reporting - Added option to include application logs when submitting bug reports
- Added What's New - Added a What's New modal to show the latest highlights of the new version
Major Authentication Enhancement:
- GitHub App Authentication - Introduced scoped repository access through GitHub App installations
- Automatic Configuration - GitHub App users get automatic repository owner detection
- Enhanced Security - Short-lived tokens with fine-grained permissions through GitHub Apps
Technical Implementation:
- UnifiedGitHubService - Introduced the service architecture that powered the GitHub App rollout
- 95% Migration Complete - Core functionality fully migrated with minor cleanup remaining
- Clean Architecture - Removed circular dependencies and improved modularity
- Comprehensive Testing - All tests updated to support new authentication architecture
Premium Features & Enhanced Functionality:
- Premium subscription system with advanced features and Supabase integration
- GitHub Issues management - Create, view, edit, and manage GitHub issues directly from the extension
- Push reminder system - Scheduled reminders and notifications for your projects
- File changes detection - Advanced diff viewer to see what's changed before pushing
- Newsletter subscription - Stay updated with latest features and tips
- Enhanced feedback system - Improved GitHub integration for bug reports and feature requests
- Branch selection modal - Better repository management with branch switching
- Commit message templates - Predefined templates for consistent commit messages
- Analytics tracking - Better understanding of usage patterns for improvements
Technical Improvements:
- Complete architecture refactoring - Modular content script architecture with specialized managers
- Comprehensive testing suite - 154 files with Jest unit tests and mock implementations
- Enhanced performance - Better file loading, caching, and state management
- Migration to pnpm - Improved package management and faster builds
- Premium authentication - Re-authentication modal and session management
Developer Experience:
- Enhanced documentation - Technical debt documentation, testing guides, and setup instructions
- Multiple AI tool integrations - Configuration files for Cline, Copilot, Cursor, Qodo, and Windsurf
- Husky pre-commit hooks - Automated code quality checks
- Service layer restructuring - Better interfaces and dependency injection
- Add Push to GitHub button in Settings popup
- Enhanced UI with better positioning and responsiveness
- GitHub dropdown menu with accessibility enhancements
- Project organization features (grouping by type: Bolt and GitHub)
- Project deletion functionality
- Repository settings management improvements
- Help button with improved resources and links to official website
- Improvements in temporary repository clean up
- Support for GitHub organization repositories
- Enhanced button feedback with permission checking status
- ZipHandler service for better file processing
- Development guide with commands and code style guidelines
- Support for Private GitHub repositories (see demo here: https://youtu.be/d9NqXRoroi0)
- Enhanced GitHub integration with token validation
- Improved repository management and temporary repository handling
- New user interface components:
- Help system and New User Guide
- Project Status dashboard
- Modal system for better interactions
- Robust error handling and rate limit management
- Task queue system for better performance
- Enhanced code quality with strict TypeScript standards
- 🚀 Automatic ZIP file interception from bolt.new
- 📦 In-browser ZIP file extraction
- 🔄 Direct GitHub repository integration
- 🔒 Secure credential storage
- ⚡ Real-time processing status updates
- 🎨 Clean, responsive UI with shadcn-svelte components
- 📱 Modern, accessible interface
- 🔄 Upload progress tracking
- 🎯 Custom upload status alerts
- ✨ Multi-repository support
- 📄 Follow
.gitignorerules for file uploads - ⚙️ Repo settings displayed in popup
- ✉️ Custom commit messages
- 💾 Automatically save new project settings
- 📋 Projects tab with quick access to all your Bolt projects:
- View all pushed projects in one place
- Open projects directly in Bolt
- Access GitHub repositories
- Import existing GitHub repos into Bolt
- Always verify your repository settings before syncing a new project
- Double-check the repository name and branch when switching between projects
To try the latest development version:
-
Clone and install:
git clone https://github.com/mamertofabian/bolt-to-github.git cd bolt-to-github # Install using pnpm (recommended) - faster and more efficient pnpm install # Or using npm if you prefer npm install
-
Build the extension:
pnpm run build
-
Load in Chrome:
- Open Chrome and go to
chrome://extensions/ - Enable "Developer mode" (top right)
- Click "Load unpacked"
- Select the
distdirectory from your project folder
- Open Chrome and go to
Note: The GitHub version contains the latest features but may be less stable than the Chrome Web Store version.
- Chrome
- Brave
Get started in just 3 simple steps:
-
Install from Chrome Web Store
- Visit our Chrome Web Store page
- Click "Add to Chrome"
- Click "Add extension" when prompted
-
Configure the Extension
- Make sure you have a Bolt.new project loaded
- Click the extension icon in your Chrome toolbar
- Sign in to your Bolt2GitHub account
- Connect the GitHub App and choose the repositories Bolt to GitHub may access
- Enter the following details:
- Repository Owner (auto-filled from the GitHub App)
- Repository Name
- Branch Name (defaults to 'main')
- Save your settings and you're ready to go!
-
Load your Bolt.new Project
- Click on the GitHub button in the Bolt.new project page at the top right
- Confirm the popup that appears
- Done!
Follow these steps to get started:
- Create a GitHub account
- Create or sign in to your Bolt2GitHub account
- Open the extension and connect the GitHub App to the repositories you want to use
If you want to modify the extension or contribute to its development:
-
Set up your development environment:
# Make sure you have Node.js v18 or later installed (v22 LTS recommended) node --version -
Clone and install:
git clone https://github.com/mamertofabian/bolt-to-github.git cd bolt-to-github # This project uses pnpm for better performance and disk efficiency pnpm install
-
Build for development:
# Development with hot reload pnpm run watch # Production build pnpm run build # Run tests (v1.3.0+) pnpm test # Lint code pnpm run lint # Format code pnpm run format
-
Set up environment variables:
# Copy the example environment file cp .env.example .env # Edit .env and add your Google Analytics API secret # Get it from: https://analytics.google.com/analytics/web/ # Navigate to: Admin > Data Streams > [Your Stream] > Measurement Protocol API secrets
-
Load in Chrome:
- Open Chrome and go to
chrome://extensions/ - Enable "Developer mode" (top right)
- Click "Load unpacked"
- Select the
distdirectory from your project folder
- Open Chrome and go to
Google Analytics event tracking is paused for v2.0.0. Do not set VITE_GA4_API_SECRET when
building the extension: Vite rejects builds that would embed this server credential in a public
Chrome package. Remove it from local .env files before building. The separate optional uninstall
feedback usage setting remains available in the extension.
This project uses shadcn-svelte for UI components. To add new components:
# Use the shadcn-svelte CLI (not the regular shadcn CLI)
pnpm dlx shadcn-svelte@latest add [component-name]
# Examples:
pnpm dlx shadcn-svelte@latest add button
pnpm dlx shadcn-svelte@latest add card
pnpm dlx shadcn-svelte@latest add dialogImportant: Always use shadcn-svelte@latest (not shadcn@latest) as this project uses the Svelte variant.
The components will be automatically added to src/lib/components/ui/ and can be imported like:
<script>
import { Button } from '$lib/components/ui/button';
import { Card, CardContent, CardHeader, CardTitle } from '$lib/components/ui/card';
</script>See our Contributing Guide for more details.
.
├── assets/ # Extension icons and assets
│ └── icons/ # Extension icons in various sizes
├── src/
│ ├── background/ # Extension background service
│ │ └── __tests__/ # Background service tests
│ ├── content/ # Content scripts with modular architecture
│ │ ├── __tests__/ # Content script tests
│ │ ├── handlers/ # Event and action handlers
│ │ ├── infrastructure/ # Core infrastructure services
│ │ ├── managers/ # Specialized UI and state managers
│ │ ├── services/ # Content-specific services
│ │ └── types/ # Content script type definitions
│ ├── lib/ # Core library and utilities
│ │ ├── __tests__/ # Library tests
│ │ ├── components/ # Reusable UI components
│ │ │ ├── ui/ # shadcn-svelte UI components
│ │ │ │ ├── alert/
│ │ │ │ ├── badge/
│ │ │ │ ├── button/
│ │ │ │ ├── card/
│ │ │ │ ├── dialog/
│ │ │ │ ├── input/
│ │ │ │ ├── label/
│ │ │ │ ├── modal/
│ │ │ │ └── tabs/
│ │ │ ├── github/ # GitHub-specific components
│ │ │ ├── EnhancedGitHubSettings.svelte
│ │ │ ├── Footer.svelte
│ │ │ ├── GitHubSettings.svelte
│ │ │ ├── Header.svelte
│ │ │ ├── NotBoltSite.svelte
│ │ │ ├── SocialLinks.svelte
│ │ │ ├── StatusAlert.svelte
│ │ │ └── UploadProgress.svelte
│ │ ├── constants/ # Application constants
│ │ ├── services/ # Core services (GitHub, storage, etc.)
│ │ ├── stores/ # Svelte stores for state management
│ │ └── utils/ # Utility functions
│ ├── popup/ # Extension popup UI
│ │ ├── components/ # Popup-specific components
│ │ ├── App.svelte # Main popup component
│ │ ├── index.html # Popup HTML template
│ │ └── main.ts # Popup entry point
│ ├── services/ # Service modules
│ │ ├── __tests__/ # Service tests
│ │ ├── interfaces/ # Service interfaces
│ │ ├── types/ # Service type definitions
│ │ ├── GitHubAppService.ts # GitHub App authentication
│ │ ├── UnifiedGitHubService.ts # Unified authentication service
│ │ ├── PremiumService.ts # Premium features service
│ │ ├── SupabaseAuthService.ts # Supabase integration
│ │ └── [other services]
│ ├── styles/ # Global styles
│ ├── test/ # Test setup and utilities
│ │ └── setup/ # Test configuration
│ └── types/ # TypeScript type definitions
├── manifest.json # Chrome extension manifest
├── package.json # Project dependencies and scripts
├── tailwind.config.js # TailwindCSS configuration
├── tsconfig.json # TypeScript configuration
└── vite.config.ts # Vite build configuration
- Svelte - UI framework
- TypeScript - Type safety
- Vite - Build tool
- TailwindCSS - Styling
- shadcn-svelte - UI components
- fflate - Zip file processing
- Supabase - Backend services and authentication
- MailerLite - Newsletter management
- Vitest - Testing framework
- Required GitHub App integration: Scoped repository access with short-lived credentials and fine-grained permissions
- Bolt2GitHub account boundary: GitHub actions require a signed-in Bolt2GitHub session
- Automatic token management: GitHub App tokens are automatically refreshed when needed
- Short-lived credential storage: GitHub App credentials are renewed automatically and stored in Chrome's extension storage
- HTTPS communication: All communication with GitHub uses HTTPS
- Browser-only processing: ZIP file processing happens entirely in the browser
- Premium authentication: Enhanced security with Supabase integration (v1.3.0+)
- Zero credential exposure: No tokens or credentials are ever logged or exposed
- 🌐 Official Website
- 📺 Watch our video tutorials
- 📖 Read the documentation
- 🔧 Bolt2GitHub account and GitHub App setup - Required connection and repository access
- 📋 Technical Documentation - Architecture and implementation details
- 🧪 Testing Reference - Testing guidelines and best practices
- 💡 Get development tips
- 💬 Discord Community
For bugs or feature requests, you have multiple convenient options:
- Click the extension icon and go to the "Help" tab
- Click the "Send Feedback" button for an easy-to-use feedback form
- Works for everyone: Whether you're authenticated with GitHub or not!
- Smart fallback: If you're not logged in, the system will guide you to submit feedback directly on GitHub with pre-filled content
- Open an issue directly on the GitHub repository
- Perfect for detailed bug reports or feature requests
- 💝 Appreciation: Share what you love about the extension
- ❓ Questions: Ask for help or clarification
- 🐛 Bug Reports: Report issues or unexpected behavior
- ✨ Feature Requests: Suggest new features or improvements
- 💬 General Feedback: Any other thoughts or suggestions
If you find this extension helpful, you can support its development:
Your support helps maintain and improve this extension!
- Fork the repository
- Create a feature branch
git checkout -b feature/my-new-feature- Commit your changes
git commit -am 'Add some feature'- Push to the branch
git push origin feature/my-new-feature- Create a Pull Request
MIT License - see LICENSE file for details
This extension requires the following permissions:
webRequest: To intercept downloadsdownloads: To manage downloadsstorage: To store settingsscripting: To interact with bolt.new
Q: Why do I need a Bolt2GitHub account and the GitHub App?
A: The account establishes your extension session, while the GitHub App grants scoped access to the repositories you choose.
Q: What happens when GitHub App access expires?
A: The extension renews its short-lived GitHub App credentials automatically. If the account or installation is disconnected, the extension shows reconnection guidance instead of attempting a push.
Q: Can I specify which files to push to GitHub?
A: Currently, the extension processes all files in the ZIP. File filtering may be added in future versions.
-
Extension not intercepting downloads
- Ensure you're on bolt.new
- Check if the file is a ZIP
- Verify permissions are enabled
-
GitHub push fails
- Confirm you are signed in to your Bolt2GitHub account
- Confirm the GitHub App is installed for the target repository
- Check repository name and owner
- Ensure branch exists
-
The extension says GitHub authentication has changed
- Follow the sign-in and GitHub App connection steps shown in the extension
- Your existing repository and project mappings are preserved during migration
-
ZIP processing errors
- Check if the ZIP file is corrupted
- Ensure file contents are text-based
- Let me know if you have any ideas for additional features or improvements by opening an issue on GitHub.
Created by AI-Driven Coder | Powered by Codefrost | Maintained by Mamerto Fabian
The extension includes a dedicated Projects tab that helps you:
- Keep track of all your Bolt projects pushed to GitHub
- Quick-access buttons to:
- Open projects directly in Bolt
- View repositories on GitHub
- Import repositories back into Bolt
- View branch information and project details at a glance