> ## Documentation Index
> Fetch the complete documentation index at: https://bilt.me/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Chat

> Build and iterate on your app through conversation

Bilt's AI agent builds your app through a conversational interface. Describe what you want, and Bilt writes the code, structures the project, and updates the live preview — all in real time.

## How it works

Every Bilt project has a chat interface. You type instructions in plain English; Bilt interprets them and modifies your app.

Each message triggers a **workflow** — Bilt plans the changes, writes or modifies code, rebuilds the app, and updates the live simulator. You see progress in real time with status updates and a thinking indicator.

## What you can ask

Bilt handles everything from high-level app descriptions to specific UI tweaks:

| Type                    | Example                                                                  |
| ----------------------- | ------------------------------------------------------------------------ |
| **Create from scratch** | "Build a workout tracker with daily logs and progress charts"            |
| **Add features**        | "Add a settings page with dark mode and notification preferences"        |
| **Change design**       | "Make the header gradient blue-to-purple and increase the font size"     |
| **Fix issues**          | "The save button doesn't work on the edit screen — fix it"               |
| **Connect services**    | "Add a backend so users can sign up and save data"                       |
| **Prepare for launch**  | "Add an app icon, splash screen, and get ready for App Store submission" |

## Attachments

You can attach **screenshots** and **images** to your messages — useful for showing Bilt a design you want to match, a bug you're seeing, or a reference from another app.

You can also **paste links** into chat. Bilt treats them as attachments and can inspect the page: read its content, understand its structure, and visually review it via screenshots. Use this when you want your app to match an existing website or reference a live page.

## Session history

Your full conversation history is saved. You can scroll back to see what the AI built, what you asked for, and how the app evolved. Each session tracks the tools used, status changes, and results.

## Tips for better results

* **Refine your prompt first** — iterate on what you want to build with an AI chatbot such as ChatGPT, Claude, Gemini, etc. before sending it to Bilt. That does not consume Bilt tokens — so it is a free way to get better results from Bilt
* **Be specific** about what you want — "add a profile page with avatar, name, and email fields" works better than "add a profile"
* **Iterate in small steps** — build the core flow first, then refine
* **Reference what exists** — "on the home screen, add a search bar at the top"
* **Describe the user experience** — "when the user taps a recipe, show the full recipe with ingredients and steps"

See the [prompting guide](/docs/guides/prompting) for more detailed advice.