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

# Quickstart: build your first iOS app with 10x

> Install 10x, sign in, describe your app idea, and watch the AI plan and build a working SwiftUI app — ready to preview on the Simulator in minutes.

This guide walks you through everything from downloading 10x to watching your first iOS app run on the Simulator. The whole process takes just a few minutes.

<Steps>
  <Step title="Download and install 10x">
    Download the latest 10x `.dmg` from the 10x website. Open the DMG, then drag **10x.app** into your **Applications** folder.

    10x is available on two release channels — stable and beta — and uses Sparkle to deliver automatic updates after you install.
  </Step>

  <Step title="Pass the system check">
    When you launch 10x for the first time, a **System Check** screen verifies that your Mac is ready to build and preview iOS apps. It checks for two things:

    * **Xcode installed** — Xcode 16 or later, opened at least once to complete first-launch setup
    * **iOS 26+ simulator available** — at least one iPhone Simulator runtime installed via Xcode > Settings > Platforms

    If anything is missing, 10x shows a setup button next to the failing requirement. Click it to install or configure what is needed. The screen rechecks automatically every few seconds, so once setup completes you can continue immediately.

    <Note>
      If Xcode is not installed, click **Get Xcode** to open the App Store page. After installing, open Xcode once so it can finish its own first-launch setup, then return to 10x.
    </Note>

    When both requirements show a green checkmark, click **Continue**.
  </Step>

  <Step title="Sign in">
    After the system check passes, 10x shows the sign-in screen. Click **Sign in with Google** to authenticate. Your browser opens briefly to complete the OAuth flow, then returns you to the app.
  </Step>

  <Step title="Describe your first app">
    You land on the home screen with a text field and a row of **suggestion chips** — quick prompts like "habit tracker", "recipe app", or "workout log" to help you get started if you do not have a specific idea yet.

    Type a description of the app you want to build, or tap one of the suggestion chips to use it as your starting point. Be as specific or as broad as you like — the AI asks clarifying questions during the planning phase if it needs more detail.

    Press **Return** or click the send button to continue.
  </Step>

  <Step title="Go through the onboarding wizard">
    A three-step onboarding wizard opens before the AI starts building. You can work through each step or click **Skip** to begin immediately.

    * **Design Direction** — choose a visual style for your app. Options include Clean & Minimal, Sharp & Focused, Bold & Expressive, Warm & Inviting, and more. A live mini-preview shows what your chosen palette and typography look like before you commit.
    * **Target Audience** — select who the app is for. You can pick multiple audiences.
    * **Additional Details** — add any extra context: specific features, inspirations, or reference images you want the AI to incorporate.

    When you are done, click **Start Building**. If you prefer to jump straight into the AI conversation, click **Skip** in the top-right corner of the wizard.

    <Tip>
      You can also click **Begin Immediately** or **Select Your Style** when creating a new project from the home screen, depending on how much setup guidance you want before the AI starts.
    </Tip>
  </Step>

  <Step title="Watch it build">
    10x opens the builder workspace, a three-pane layout:

    * **Left sidebar** — a VS Code-style file explorer showing every Swift file the AI generates
    * **Center panel** — the chat view with the AI's messages, inline questions, and tool steps
    * **Right panel** — the Simulator preview and project plan

    The AI first enters **Plan mode**: it researches your concept, may ask a clarifying question or two in the chat, and creates a project plan. Once planning is complete, it switches to **Build mode** and starts writing SwiftUI code. You can follow along in the file explorer as files are created and edited in real time.
  </Step>

  <Step title="Preview your app on the Simulator">
    When the AI finishes building, 10x automatically boots an iPhone Simulator, compiles your app, installs it, and captures a screenshot. The screenshot appears in the right panel so you can see your running app without switching to the Simulator window.

    From here you can continue the conversation: ask the AI to add a new screen, change the color scheme, fix a bug, or anything else. Each change triggers a new build and preview cycle.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Plan and Build modes" icon="wand-magic-sparkles" href="/building/plan-mode">
    Learn how the two AI modes work and when each one runs.
  </Card>

  <Card title="Design styles" icon="palette" href="/building/design-styles">
    Explore the full set of visual styles available in the onboarding wizard.
  </Card>

  <Card title="Simulator preview" icon="mobile-screen" href="/preview/simulator-preview">
    Understand how 10x compiles and launches your app on the Simulator.
  </Card>

  <Card title="Supabase integration" icon="database" href="/integrations/supabase">
    Connect a real backend to your generated app.
  </Card>
</CardGroup>