Creating a project

Watch it in action

Watch: typing an app name on the studio home, pressing Send, and the project creating itself.

A project is your app's home inside FlutterGo.AI. It holds your Flutter code, your chat with the AI, your design files, and your live preview, everything in one place.

There are two ways to start. You can type an app name on the Home screen and let FlutterGo.AI set everything up for you. Or you can use the New project dialog, where you control the details: the name, the design system, the target platforms, and how polished the first version should be.

Here we walk through the New project dialog step by step. It's written for first-time users. You don't need to know anything about Flutter or coding.

By the end you'll have a new project open in the workspace, with the AI ready to build your app.

What you need#

• Sign in to FlutterGo.AI in your browser. Your projects are saved to your account.
• Have a short description of your app idea ready (one or two sentences is enough).
• Optional: pick a design system first if you want your app to match a brand (see the chapter "Templates & design systems").

How to do it#

1. Start from the Home screen (the quick way)#

The fastest way to create a project is the prompt box on the Home screen. Type what you want to build into the box that says Describe what you want to generate…, make sure the Android and iOS app chip is selected, keep the mode on Design, and press Send. FlutterGo.AI creates the project for you and starts building.

The Home screen: ① the prompt box, ② the Android and iOS app chip, ③ the Design mode, ④ the Send button.

Tip: The quick way uses sensible defaults. If you want to choose the design system, platforms, and fidelity yourself, use the New project dialog instead, that is what the rest of this chapter covers.

2. Open the New project dialog#

In the left sidebar, click New project. A dialog opens. At the top you can see tabs for different project types. Make sure the Android and iOS App tab is selected, the dialog title changes to New Android and iOS App.

3. Fill in the top of the dialog#

The top of the dialog has three things: the project name, the design system, and the target platforms.

Type a name into the Project name field. Pick something short and clear, like "Coffee Shop App". You can rename the project later, so do not worry about getting it perfect.

The top of the New project dialog: ① Project name, ② Design system, ③ Target platforms.

4. Choose a design system (②)#

The Design system picker controls the visual style of your app, colors, fonts, and overall feel.

• The default is None, freeform. This means: "Skip system tokens. The agent picks its own palette." The AI invents a style that fits your prompt.
• Click the picker to open the list. Use Search design systems… to filter. Your default system shows a DEFAULT badge.
• The Single / Multi switch lets you pick one system or blend several as inspiration.

Tip: Selected design systems are inspiration only, the AI follows their spirit, not every pixel. If you have no brand yet, None, freeform is a great start.

5. Pick target platforms (③)#

The Target platforms picker tells the AI which devices your app is for. Pick one or more:

6. Turn on companion screens (optional)#

Below the platforms you'll find Companion screens, extra surfaces the AI can build alongside your app:

• Include landing page, "Add a responsive marketing page for ads, waitlists, launch campaigns, app downloads, or product explanation."
• Include OS widgets, "Add platform-native home screen, lock screen, or quick-access widgets for mobile/tablet apps."

Important: The OS widgets toggle is only available when iOS, Android, or tablet app is selected as a target platform. If it looks disabled, check your platform choices in Step 5.

7. Choose where the project is saved (the Local storage row)#

Next to the project name there is a button labeled Local storage. Its tooltip says "Saved in local storage, click to choose a folder."

• If you leave it alone, your project is stored by FlutterGo.AI automatically. Most people should do this.
• If you click it, you can choose a folder so the project also lives at a place you pick. A small × button (Clear working directory) removes your choice.

Tip: The folder picker needs the desktop app. In a plain browser you may see: "Folder picker is unavailable in this build. Run the desktop app to pick a folder."

8. Pick the fidelity and click Create#

Scroll to the Fidelity section. It has two options:

When everything looks right, click Create.

The bottom of the dialog: ④ Layout draft, ⑤ Polished UI, ⑥ the Create button.

9. Watch your project open#

FlutterGo.AI opens the workspace: your conversation with the AI on one side, the canvas and live preview on the other. The AI starts building right away.

The workspace after creating a project: ① GitHub banner, ② conversation, ③ canvas, ④ preview rail, ⑤ toolbar.

Success: You created your first project. The footer of the dialog reminded you of an important fact: "Only you can see your project by default." Nothing is shared until you share it.

Common mistake: Writing a whole spec in the project name field. The name is just a label, put your app description in the chat prompt instead.

Troubleshooting#

Problem: Clicking Create shows "Could not create the project. Sign in and try again." Possible causes: You are signed out, or the session expired. Solution:

1. Click the avatar menu and check you are signed in.
2. Sign in again if needed.
3. Reopen the New project dialog and click Create again.

Problem: The Include OS widgets toggle is grayed out. Possible causes: No mobile or tablet platform is selected. Solution:

1. Open Target platforms.
2. Add iOS app, Android app, or Tablet app.
3. The toggle becomes available.

Problem: The Local storage button does nothing useful in the browser. Possible causes: The folder picker only works in the desktop app. Solution:

1. Keep the default storage, or
2. Download the desktop app (Help menu, then Download desktop app) and pick a folder there.

FAQ#

Do I need to know Flutter to create a project? No. You describe your app in plain language. FlutterGo.AI writes the Dart/Flutter code for you.

Can I change the design system after creating the project? Yes. Inside the chat you can switch the design system at any time (Add context, then Skills and design systems, then Choose a design system).

What is the difference between Layout draft and Polished UI? Layout draft is a fast rough version for exploring structure. Polished UI takes longer but looks close to a finished product.

Can I pick more than one target platform? Yes. The hint in the dialog says "Pick one or more." The AI adapts the app to each platform you choose.

Who can see my new project? Only you. The dialog footer says "Only you can see your project by default." Sharing is always your choice.

Is my project name final? No. You can rename a project later from the projects list (More actions, then Rename).

Where to go next#

• Importing an existing app
• Templates & design systems
• Your code: export, download & local mode