Your code: export, download & local mode

The code FlutterGo.AI writes is yours. Here we show every way to get it out and work with it: connecting a GitHub repository, viewing the code inside the app, downloading files, and running your project on your own computer with Local Mode.

GitHub is the recommended home for your code. Once connected, your project pushes and pulls like any other repository, and GitHub becomes the bridge that keeps Cloud and Local Mode in sync.

You don't need to be a Git expert. The buttons in FlutterGo.AI do the work; this chapter explains what each one means before you press it.

Your code flows from the FlutterGo.AI workspace to a GitHub repository you own.

What you need#

• A GitHub account (free is fine) if you want to save your code to GitHub.
• Local Mode requires the Pro plan and the FlutterGo Local desktop app.
• Open the project whose code you care about.

How to do it#

1. Connect GitHub to own your code#

When a project has no linked repository, a GitHub banner appears at the top of the workspace with the message "Connect GitHub to save your code."

The GitHub banner prompts you to save your code to a repository you own.

The banner offers two setups, explained as: "Create a new private repository and push your code, or link one you already have on GitHub."

• Create new: type a Repository name and click Create repo & push code.
• Link existing: pick from Your repositories and click Link & push code.

If GitHub is not connected yet, click Connect GitHub first and approve the FlutterGo app in the GitHub window.

2. Push and pull changes#

After linking, the GitHub toolbar shows your repo as repo@branch. It tells you the sync state:

• "✓ Up to date with main", nothing to send.
• "3 changes to push", you have local work to save.

Click Push to send your changes to GitHub. Click Pull to bring changes from GitHub into your project.

Push sends your work to GitHub; Pull brings remote changes in.

Tip: Push often. Your GitHub repository is a full backup of your app that lives outside FlutterGo.AI.

3. View the code with Show code#

In the Flutter preview panel, click Show code. The panel switches from the Preview tab to the Code tab, with a Files list of every Dart and config file. Click Hide code to go back.

4. Download files#

Two places let you download:

• Share menu: open a file, click Share, and look in the DOWNLOAD section. Source files, then Download as .zip gives you the files as a zip. Other formats like Export as standalone HTML, Export as PDF, and Export as image are there too, depending on the file type.
• Design Files panel: select files, then click Download (or Download {n} as ZIP for several at once).

5. Understand Cloud Mode vs Local Mode#

FlutterGo.AI can run your project in two modes. Cloud is the default.

Important: Local Mode requires the Pro plan. The toggle explains: "Local Mode is included on Pro and above."

6. Switch to Local Mode#

1. Open Settings and find the Cloud / Local toggle.
2. Click Local. FlutterGo.AI shows "Looking for FlutterGo Local…".
3. If the FlutterGo Local app is not installed, you'll see "FlutterGo Local isn't running" with a Download button. Install it once, it starts automatically afterwards.
4. When pairing succeeds you see Local Connected ✓, plus a check of your machine: Flutter, Xcode, Android SDK, Git, Claude Code, Codex, Cursor.

Success: When you switch modes on a GitHub-connected project, FlutterGo.AI syncs safely: it pushes your pending work first, switches, then pulls in the new mode. You'll see "Syncing your project before switching…" while this happens.

7. Give the agent a working directory (Select working directory)#

On the Home screen composer you can click Select working directory. Its hint says: "Let the agent read this local folder (not imported into Design Files)." Use Choose folder to pick, Recent folders to reuse one, and Remove working directory to clear it. This lets the AI read reference code on your machine without importing it.

Common mistake: Confusing the two folder pickers. Select working directory gives the agent read access to a folder. The Local storage row in the New project dialog chooses where a new project is saved. They are different features.

Troubleshooting#

Problem: The GitHub banner says "GitHub did not confirm the installation." Possible causes: The install window was closed early, or the app was installed for the wrong account. Solution:

1. Click Try again, FlutterGo.AI detects an existing install automatically.
2. If not, click Connect GitHub and finish every GitHub screen, choosing All repositories when asked.

Problem: "Couldn't sync before switching" appears when changing run mode. Possible causes: The push to GitHub failed, so FlutterGo.AI refused to switch and lose work. Solution:

1. Open the GitHub toolbar and click Push manually; fix any error it shows.
2. Try the mode switch again.
3. As a last resort the dialog offers switching without syncing, only use it if you accept that unpushed work may not appear in the other mode until you push.

Problem: Local Mode shows "FlutterGo Local isn't running." Possible causes: The desktop companion app is not installed or not started. Solution:

1. Click the Download button and install FlutterGo Local.
2. Start it once; it then runs automatically in the background.
3. Click Retry in Settings.

FAQ#

Who owns the code FlutterGo.AI writes? You do. Push it to your own GitHub repository and it is yours like any other codebase.

Is my repository public? The Create new flow makes a private repository by default. You control visibility on GitHub.

Can I edit the code by hand? Yes. Use Show code to view files in the app, or clone your GitHub repo and edit in any editor. Pull your edits back into FlutterGo.AI with Pull.

Do I need GitHub to use Local Mode? No, but it is strongly recommended. With GitHub connected, mode switches sync through your repository. Without it, FlutterGo.AI copies the project directly between the cloud and your machine.

What does "changes to push" mean? It counts files that differ between your project and the linked GitHub branch. Push sends them; the line then reads "✓ Up to date".

Can I download my whole project as a zip? Yes. Open the Design Files panel, select everything, and use Download {n} as ZIP, or use Download as .zip from the Share menu's DOWNLOAD section.

Where to go next#

• Importing an existing app
• Sharing your project
• Creating a project