Troubleshooting & FAQ
The preview will not start or looks stuck#
- Click Stop, then Run app again.
- Still stuck? Tap Clean in the top toolbar, then Pub get, then run again.
- If the agent just made a big change, wait a moment. The first compile is always the slow one. Hot reload is much faster after that.
"Running flutter analyze…" shows issues#
That is normal while the agent is still working. It usually fixes analyzer warnings on its own. If they stick around, ask: "fix the analyzer errors".
GitHub connect problems#
| Symptom | What to do |
|---|---|
| GitHub window shows a 404 | This is usually the GitHub account, not FlutterGo. New accounts are sometimes flagged and cannot install apps until GitHub clears them. Check your GitHub settings or try another account. |
| Stuck on "Connecting…" | The popup may have closed too soon. Click Retry. If you already installed FlutterGo on GitHub, it should reconnect. |
| "Server OAuth is not configured" (self-hosted) | Your admin needs to set the GitHub App client ID and secret on the server. |
| Repo creation asks to Authorize | Personal accounts need a one-time approval before repos can be created. After that it is automatic. |
| "Your GitHub authorization expired or was revoked" | Run the action again and approve the popup once more. |
The agent misunderstood my prompt#
- Say "revert the last change" to undo one step, or restore an older commit from GitHub.
- Try again with the screen name and one specific change.
- Use the Current Design Files chip to limit the edit to the file you have open.
Where is my code? Can I take it elsewhere?#
Your project lives in your GitHub repo as standard Flutter code. Clone it, open it in Android Studio or VS Code, and take it anywhere. There is no lock-in.
How do I report a bug or ask for a feature?#
Open the ? Help button in the studio (beside the preview on a project). From there you can reach support, feature requests, Discord, and release notes.