When you’re done, you’ve sent a prompt, and the agent is building your app’s first version from it.

What to include

A prompt says what your app does, who it’s for, and the style you like.

• What it does. Name the screens, and say what each one shows, such as “Today shows each habit as a card.”
• What happens when someone taps. Say where a tap goes, such as “Tap a habit to see its streak.”
• Who it’s for. Name the people who use the app, such as “for busy parents” or “for people who buy from small makers.”
• The style you like. Describe the mood, the colors, and the fonts, such as “Warm and quiet, soft greens, rounded cards.”

For example:

Example request

“A recipe app for people who cook on weeknights. Home shows tonight’s suggestion as a big photo card, then saved recipes as a grid. Tap a recipe for its ingredients and steps; tap a step to start its timer. A Shopping tab lists what to buy for the week. Fresh and simple: white background, one tomato-red accent, large rounded type.”

Start from an example

FlutterFlow offers three example prompts. Each one states what the app does, who it’s for, and what style it has. To use one, click finance app, habit tracker, or marketplace under the prompt box. The example replaces what’s in the box, and you can edit it before sending.

Send a prompt

To write a prompt and build your app’s first version:

1. Open Home.
2. In the prompt box, write your prompt.
3. Optional: To give the agent references such as a logo, a screenshot, or a font, click Attach files. See Attachments.
4. Click Build the first version.

Limits

A prompt can be 12 to 8,000 characters long.

• If your prompt is too short, FlutterFlow shows “Say a little more about the app: who it is for and what it does.” Add detail and send it again.
• As your prompt nears the limit, a ring next to Attach files shows how many characters remain. If your prompt exceeds the limit, shorten it before you send it.

See Limits.

Start another app

Each new app starts from its own prompt. Open a new prompt box from any of these places:

• On Home: Under “What should we build next?”, write in the prompt box.
• Inside an app: Click your app’s name next to the FlutterFlow logo, and then click New app.

Then write and send your prompt, starting at step 2 of Send a prompt.

Your account includes one free build, which covers your first version until the free build runs out. On a paid plan, a first version running on your free build leaves your allowance untouched; on Free, a first version runs on your free build whatever your allowance has left, and stops if the free build runs out.

If a first version fails, you can try again in the same thread, and it keeps running on your free build until the free build runs out. Starting another first version on your free build needs enough of it left for a whole one. Plan & usage tracks your free build under Free builds.

On a paid plan, any part of a first version not covered by your free build uses your allowance. Once your free build is in use or used up, starting a new app requires enough allowance for a full first version; otherwise, sending a prompt opens the plan picker with “Not enough allowance left for a new app” and saves your prompt.

Your free build can also cover the first change you ask for after your first version lands, and pushing that change to your app; after that, your next message needs allowance.

On Free, you can start a new app only with your free build. Sending a prompt for another app while your free build is running or after it is used opens the plan picker with “You’ve used your free build” and saves your prompt. You can continue updating your existing apps on Free, or upgrade to a paid plan to create more apps.

Troubleshooting

For problems when you send a prompt or while the first version builds, see Troubleshoot getting started.