The preview will not start or looks stuck#
- Read the status under the round run button in the right panel. Writing code… means the agent is still working, and the preview waits for it. A first build takes a minute or two.
- Click Stop (the small square on the run button), then press the run button again (Run app or Rebuild).
- If Analysis shows errors, click Fix with AI. It does not use a credit, and the preview rebuilds when the code is clean.
- Still stuck? Tell the agent in the chat, for example "the preview is stuck, please check it and rebuild".
On the Free plan, the preview runs only while you have credits, and for 30 minutes after your last one. If it says you are out of credits, buy a credit pack or upgrade.
"Running flutter analyze…" shows issues#
That is normal while the agent is still working. It usually fixes analyzer errors on its own. If they stick around, click Fix with AI under Analysis, which does not use a credit, or Check again to run the check once more. You can also ask: "fix the analyzer errors".
GitHub connect problems#
GitHub is in the right panel, under Ship → GitHub, from the Pro plan. The full guide is Save your code to GitHub.
| 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 Waiting for GitHub…, or "GitHub connect timed out" | The pop-up was blocked or closed too soon. Allow pop-ups for fluttergo.ai and click Connect GitHub again. If you already installed FlutterGo on GitHub, it reconnects. |
| "Your GitHub authorization expired or was revoked" | Click Create repo & push code again and approve the GitHub window once more. |
| "GitHub access expired", and a repository is missing from the list | Click Reconnect GitHub access. |
| Your latest changes are not on GitHub | FlutterGo never pushes on its own. Open Ship → GitHub and click Push. |
The agent misunderstood my prompt#
- Tell the agent what went wrong and what you expected, for example "undo the last change to the home screen".
- Try again with the screen name and one specific change.
- Not sure how to put it? Switch the chat to Plan and talk it through first: Plan mode doesn't change your code.
- Pushed a good version to GitHub earlier? Save your code to GitHub shows how to bring it back. Only pushed work can be recovered.
Where is my code? Can I take it elsewhere?#
Your project is standard Flutter code, and you can read and edit it any time with Show code in the right panel. On the Pro plan and up you can take it anywhere: Download code, under Ship, gives you a ZIP, and GitHub sync puts it in a private repository in your GitHub account. Open it in Android Studio or VS Code. Code in your GitHub repository stays yours, even if your plan ends. There is no lock-in.
The chat says "Help only · out of credits"#
At 0 credits the chat still answers questions about FlutterGo, your plan and your credits, a limited number a day, but it doesn't build or change your app. Your project is kept. These still work for free: Fix with AI and the automatic repairs, Retry on a failed turn, and answering the agent's questions. Click Buy credits or upgrade to keep building. On the Free plan the preview stops too, until you top up.
I can't start a new project#
- "Building is on hold until the address is confirmed." Open the confirmation email from FlutterGo and click its link. No email? Check your spam folder, then click Resend link.
- "Your plan includes 2 projects and you have 2." The Free plan allows 2 projects of your own; projects shared with you don't count. Delete one in Projects, or upgrade: paid plans have no project limit.
A button asks me to upgrade#
Some features come with a paid plan:
- Starter and up: Build APK (a test APK).
- Pro and up: your own AI and MCP, signed release builds (APK and .aab), Download code and GitHub sync, store Deploy to Google Play and the App Store, the Admin and Website modules of an app, and publishing to your own Vercel.
- Business and up: the Secrets Vault.
How do I report a bug or ask for a feature?#
Open Help: the button in the dock beside the phone in the studio, or the ? at the bottom of the sidebar. Message us reaches FlutterGo support on WhatsApp or by email, and Guides has the documentation, feature requests and what's new. You can also visit fluttergo.ai/support. If support asks for details, Settings → About → Download debug zip makes a small zip with recent logs.