Below are the most common issues with GitHub Export and how to resolve them.
The "Push to GitHub" option is not visible
GitHub Export is not available on all accounts by default. If you don't see the Push to GitHub option in your project settings menu, the feature may not be enabled on your account yet. Contact support and we can enable it for you.
The "Push to GitHub" option is greyed out or unavailable
GitHub Export requires your project to have at least one draft — a version of your app that the AI has built. If your project has no draft yet (for example, you have just created the project but haven't run a build), the export option will be unavailable.
To resolve this, send a message in the chat to start a build. Once the AI has generated and deployed a draft of your app, the export option will become available.
The GitHub authorization window was blocked or timed out
When you click Sync to GitHub, Caffeine opens a popup window and waits for you to complete the GitHub App installation. If the popup is blocked or the installation is not completed in time, the connection attempt will fail with the message: "GitHub App installation timed out. Please try again and follow the installation instructions in the pop up window. Disable any browser pop up blockers."
If this happens:
- Check your browser's address bar for a blocked popup notification and allow the popup from there.
- If you use an ad-blocker or browser extension that blocks popups, temporarily disable it and try again.
- Once popups are allowed, click Sync to GitHub again and complete the installation promptly in the popup window.
I closed the GitHub authorization window before finishing
If you close the GitHub App installation popup before completing the authorization, Caffeine detects this and shows an error: "GitHub application Install & Authorize aborted by user."
This is expected. To connect your GitHub account, the installation must be completed in full — closing the window partway through cancels the process.
To try again, open Push to GitHub from your project settings and click Sync to GitHub to restart the authorization flow from the beginning.
I authorized GitHub but nothing happened
After authorizing, the GitHub window should close automatically and your first export should begin. If the window closed but no export started:
- Refresh the page and open Push to GitHub again.
- If your account is now shown as connected, click Save Changes to GitHub to trigger the export manually.
- If the connection still shows as unlinked, try the authorization flow again.
My export is taking a long time
Exports are processed asynchronously. After you click Save Changes to GitHub, Caffeine queues the export and processes it in the background — this typically takes a few minutes. You don't need to stay on the page while it runs. You will receive a chat message when the export completes, or if it encounters a problem.
If no commit appears in your GitHub repository after 10 minutes and you have not received a completion message in chat, try exporting again.
I get an error saying "No GitHub installation found"
This means Caffeine can't find a connected GitHub account for your project. This can happen if:
- You revoked or uninstalled the Caffeine GitHub App from your GitHub account settings.
- The connection was made under a different account.
To fix this, go to Push to GitHub in your project settings and reconnect your GitHub account by following the authorization flow again.
The export says it succeeded but I don't see the commit in GitHub
Exports create commits on the main branch. Make sure you're looking at the correct branch in GitHub (some repositories default to showing a different branch).
If the AI detected that no files changed between the current build and the previous export, no commit is created — this is expected behavior and is not an error.
I can't create a private repository
Private repository creation requires an active paid subscription. If the Private option is greyed out in the export dialog, upgrade your plan and try again.
My repository name was rejected
Repository names can only contain lowercase letters, numbers, and hyphens, and must be 100 characters or fewer. Names with uppercase letters, spaces, or special characters (other than hyphens) are not accepted by GitHub.
I accidentally connected the wrong GitHub account
At the moment, you can disconnect and reconnect your GitHub account by revoking the Caffeine GitHub App from your GitHub account settings (GitHub → Settings → Applications → Authorized GitHub Apps or Installed GitHub Apps), and then reconnecting from within Caffeine. Contact support if you need further help.
Exports keep failing even though I'm logged into GitHub
If you have already authorized GitHub but exports consistently time out or fail, the GitHub App installation may be in a broken state. This can happen if the initial authorization completed partially or if browser settings interfered with the process.
To fix this:
- Go to your GitHub settings: Settings → Applications → Installed GitHub Apps (or visit
github.com/settings/installationsdirectly). - Find caffeine-ai in the list and click Uninstall.
- Return to Caffeine, open Push to GitHub in your project settings, and click Sync to GitHub to start a fresh authorization.
- When the GitHub popup appears, complete the installation promptly — the authorization window times out after 60 seconds.
This resets the connection cleanly and resolves most persistent export failures.
The export failed partway through
If a file in your project fails to load, Caffeine skips that file and continues with the rest. In rare cases this can result in an incomplete repository. If you suspect files are missing, try triggering another export — subsequent exports push a new commit with the full current state of your project.
I see "Export to GitHub could not complete — another export was in progress"
This message appears in your chat when a manual export could not start because another export for the same project was already running at the same time. Caffeine automatically retries in the background before giving up and notifying you.
To resolve this, wait a moment and then try your export again. The previous export will have finished by the time you retry.