> ## 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.

# Open your 10x-generated iOS project in Xcode

> Open your 10x project in Xcode to run on a real device, customize build settings, add capabilities, or make advanced edits to the generated code.

10x gives you full access to the Xcode project it generates. When you need to go beyond what the Simulator preview offers — running on a physical device, adding an entitlement, tweaking build phases, or editing code directly — you can open the project in Xcode with one click.

## Open in Xcode

Click **Open in Xcode** in the preview panel. 10x opens the generated `.xcodeproj` file in Xcode. From there you can build, run, and edit the project like any standard Xcode project.

<Note>
  The **Open in Xcode** button is available as soon as 10x has generated files for your project, even before a Simulator preview has run.
</Note>

## Show in Finder

Click **Show in Finder** to reveal the project folder in Finder without opening Xcode. This is useful when you want to copy files, inspect assets, or open the folder in a terminal.

## What the project contains

The generated project includes everything Xcode needs to build and run your app:

| File / folder             | Purpose                                                  |
| ------------------------- | -------------------------------------------------------- |
| `App.swift`               | The SwiftUI entry point (`@main`)                        |
| `ContentView.swift`       | The root view of your app                                |
| `Views/`                  | Additional screens and UI components                     |
| `Models/`                 | Data models and business logic                           |
| `project.yml`             | XcodeGen spec — the source of truth for project settings |
| `{TargetName}.xcodeproj/` | The Xcode project generated from `project.yml`           |
| `DerivedData/`            | Local build artifacts                                    |

## Editing in Xcode

You can freely edit code, add files, and change settings in Xcode. Keep in mind:

<Note>
  Changes you make directly in Xcode won't automatically appear in 10x's file explorer. The file explorer reflects what 10x has written; it doesn't watch the filesystem for external edits.
</Note>

If you want 10x to incorporate changes you've made in Xcode, describe what you changed in the chat and ask the AI to continue from there.