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

# How 10x turns your idea into a running iOS app

> Learn how 10x turns a plain-language prompt into a running iOS app — from your first description through plan mode, build mode, and Simulator preview.

Every 10x project starts with a single prompt. From there, the AI researches your concept, writes production-quality SwiftUI code, scaffolds a complete Xcode project, and launches a live preview on the iOS Simulator — all without leaving the app. This page walks through the full flow so you know what to expect at each stage.

## The full build flow

<Steps>
  <Step title="Write your prompt">
    On the home screen, type what you want to build in the text field and press **Enter** or click the arrow button. You can also click one of the suggestion chips for a starting idea, or hit the refresh button to see a new set of suggestions.
  </Step>

  <Step title="Choose how to start">
    After submitting your prompt, 10x asks how you'd like to begin:

    * **Select Your Style** (recommended) — opens a 3-step wizard where you pick a design style, target audience, and any additional details before the AI writes any code.
    * **Begin Immediately** — skips customization and lets the AI make all design decisions on its own.
  </Step>

  <Step title="Plan mode">
    The AI enters plan mode. It researches your concept, asks you a short set of clarifying questions, and produces a structured project plan covering features, screen flow, design direction, and architecture. No code is written yet.
  </Step>

  <Step title="Build mode">
    Once planning is complete, the AI switches to build mode and starts writing SwiftUI code. You watch its progress in the chat panel as it creates and edits files. When it finishes, the app is compiled automatically.
  </Step>

  <Step title="Live Simulator preview">
    10x boots an iPhone Simulator, installs your app, and captures a screenshot directly into the preview panel. You can send follow-up messages at any time to request changes or new screens.
  </Step>
</Steps>

## Where projects are stored

10x saves all generated files locally on your Mac at:

```
~/Library/Developer/TenXApp/{project-slug}/
├── ios/
│   └── {TargetName}/
│       ├── App.swift
│       ├── ContentView.swift
│       ├── Views/
│       ├── Models/
│       └── ...
├── project.yml
├── {TargetName}.xcodeproj/
└── DerivedData/
```

The `ios/` folder contains every Swift file the AI generates. `project.yml` is the XcodeGen spec used to produce the `.xcodeproj`. `DerivedData/` holds local build artifacts and is not meant to be edited directly.

## Creating a new project

Type your idea into the prompt field on the home screen and press **Enter** (or click the arrow button). The prompt field expands as you type and supports up to a few lines. You can attach files or images before submitting — see [Attach files and images](/building/attachments) for details.

<Tip>
  Not sure what to build? Click any suggestion chip below the prompt field to fill it in automatically, then adjust the text to fit your idea. Hit the refresh button next to the chips to see a new set of suggestions.
</Tip>

## Opening an existing project

Your projects appear as cards below the prompt field on the home screen, organized under **Recent Projects**. Click any card to reopen that project. If you have more projects, switch to the **Archived** tab to find ones you've archived.

## Managing your projects

Right-click any project card to open the context menu. From there you can:

| Action                 | Description                                                                                                       |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Open**               | Opens the project in the builder workspace.                                                                       |
| **Rename**             | Opens a dialog where you can enter a new name.                                                                    |
| **Archive**            | Removes the project from your active list. Generated files and conversation history stay on disk.                 |
| **Unarchive**          | Restores an archived project back to your active list. Available from the **Archived** tab.                       |
| **Delete Permanently** | Removes the project from the archive and deletes all local files and conversation history. This cannot be undone. |

<Warning>
  **Delete Permanently** removes the project's Swift files and chat history from disk. There is no undo. Archive the project first if you might want to refer back to it later.
</Warning>

You can also use the icon buttons on the top-right corner of each project card: the archive icon archives an active project, and the trash icon (shown only on archived cards) triggers permanent deletion.