Set Up Xcode for Modaal: Install, Simulators, Verify
Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup: the three steps before Modaal can build and run your iOS app.
Xcode is Apple’s development environment for building and running iOS apps. Modaal drives it for you behind the scenes — you never have to write Swift in Xcode or wire up a project there. You just need it installed, opened once, and with the iOS simulators downloaded. Modaal does the rest. What Modaal adds on top of Xcode is on modaal.dev.
Everything is driven from one place inside Modaal. Click your profile avatar in the top-right corner to open the User Menu, then choose Set up Xcode.
User Menu → Set up Xcode. The colored dot shows your current status — green when Xcode is ready, orange when it still needs attention.
Keep this panel open while you work through the steps below. After each step you’ll come back to it and press Check / Re-check to let Modaal re-detect your setup.
Step 2 — Open Xcode once and download the simulators
This is the step that trips most people up. Installing Xcode is not enough — you have to launch it once so it can finish its own setup and download the iOS simulators. Until you do, Modaal shows Attention needed:
“Attention needed” — Xcode is installed (note the path and version), but Runtimes show “None” and there are no iOS Simulators yet.
1
Launch Xcode and accept the license
Open Xcode from your Applications folder. The first time it runs, it asks you to agree to the Xcode and Apple SDKs Agreement. Read it, then click Agree (you’ll be asked for your Mac password).
First launch asks you to accept the license agreement.
2
Choose the iOS platform and download it
Xcode then offers to install platform components. Make sure iOS is checked and click Download & Install. You can leave watchOS, tvOS, and visionOS unchecked — Modaal only needs iOS to build and run iPhone apps.
Tick iOS, then Download & Install. iOS is the only platform Modaal needs.
If Xcode doesn’t show this screen on launch, you can trigger it any time from Xcode → Settings… → Components, then download an iOS simulator runtime.
3
Wait for the simulator runtime to download
The iOS simulator runtime is several gigabytes and downloads in the background. You can watch progress in Xcode’s Downloads window.
The iOS simulator runtime downloading. Let it finish completely.
4
Confirm it finished
When the download completes, the runtime shows a checkmark and Xcode opens its welcome window. Xcode is now fully set up.
Download complete — the iOS simulator runtime is installed.
You can quit Xcode now — Modaal launches it on its own when it needs to build.
Go back to Modaal’s Set up Xcode panel and click Re-check. Modaal probes your installation and, when everything’s in place, switches to Installed (green) and lists the iOS simulators it found.
“Installed” — Xcode is set up with iOS simulators. You're ready to build and run.
That’s it — you can now ask Modaal to build and run your app, and it’ll launch it on the iOS simulator for you.
You can also re-validate from the User Menu via Run system check, which re-checks Xcode along with Modaal’s other prerequisites.
If you keep several Xcode versions (for example a stable release and a beta), Modaal lists each one and marks which is active — the one macOS will use for builds. To switch, click Set as active on the version you want.
With multiple Xcodes installed, click “Set as active” on the one you want Modaal to build with.
macOS asks for your administrator password to make the switch (it runs Apple’s xcode-select under the hood). If the button ever fails, the panel shows the exact command you can run yourself in Terminal:
Fix “Attention needed”, missing runtimes and Set as active
Modaal still says “Attention needed” after installing Xcode
You almost certainly skipped Step 2. Installing Xcode is not enough — open it once, accept the license, and download an iOS simulator runtime from Xcode → Settings… → Components. Then click Re-check in Modaal.
“Runtimes: None” / no iOS Simulators listed
The simulator runtime hasn’t been downloaded. In Xcode, go to Settings… → Components, download an iOS runtime, wait for it to finish, then Re-check in Modaal.
The build succeeded but no simulator window appeared
On recent Xcode versions the simulator viewer can’t launch when Xcode is installed on an external or ownership-disabled volume. Move Xcode to your internal /Applications folder, or re-enable ownership on the volume with sudo diskutil enableOwnership <volume>. The build itself still ran — this only affects showing the window.
“Set as active” keeps failing
Make sure you entered the correct administrator password. As a fallback, copy the sudo xcode-select -s … command the panel shows and run it directly in Terminal.
I'm running low on disk space
Xcode plus simulators can easily use 30–50 GB. Remove old simulator runtimes you don’t need from Xcode → Settings… → Components, and check → System Settings → General → Storage for other large items.
Still stuck? Join our community on Discord — we’re happy to help you get set up.
Last modified on September 17, 2026
Was this page helpful?
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Modaal Docs","description":"Everything you need to know to build with Modaal","colors":{"primary":"#F67AD0","light":"#61734B","dark":"#A5A2B5"},"logo":{"light":"https://mintcdn.com/modaal/rBROILWhBGfA_4EY/logo/WhiteBg.svg?fit=max\u0026auto=format\u0026n=rBROILWhBGfA_4EY\u0026q=85\u0026s=02734f2e581ce4012a11be410fbfe02d","dark":"https://mintcdn.com/modaal/rBROILWhBGfA_4EY/images/WhiteBg(1).svg?fit=max\u0026auto=format\u0026n=rBROILWhBGfA_4EY\u0026q=85\u0026s=0185f3e9df88428c430b0b130b94d569"},"favicon":"https://mintcdn.com/modaal/-XVPr0fINF-GLBnY/images/1iOS%E2%80%93AppIcon.png?fit=max\u0026auto=format\u0026n=-XVPr0fINF-GLBnY\u0026q=85\u0026s=dfdf1770b679c631ef4590398b680f7b","background":{"decoration":"gradient","color":{"light":"#F5F2F4","dark":"#050021"}},"footer":{"socials":{"github":"https://github.com/modaaldev","linkedin":"https://www.linkedin.com/company/modaalagent","discord":"https://discord.gg/ng84Jm92tm","website":"https://modaal.dev","reddit":"https://www.reddit.com/r/modaal"}},"seo":{"organization":{"id":"https://modaal.dev/#organization","name":"Modaal","url":"https://modaal.dev/","sameAs":["https://www.linkedin.com/company/modaalagent/","https://discord.gg/ng84Jm92tm","https://www.reddit.com/r/modaal/"]},"indexing":"navigable"},"styling":{"eyebrows":"section","latex":true},"integrations":{"posthog":{"apiKey":"phc_4iFGSevcFUq9oFAjmJmqeJH5rCtKBdUOIScXSg0S4J3","apiHost":"https://s.modaal.dev","sessionRecording":false},"telemetry":{"enabled":true}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"thumbnails":{"appearance":"light","background":"https://mintcdn.com/modaal/rD1fIwcYYC-vR4_F/images/bg.png?fit=max\u0026auto=format\u0026n=rD1fIwcYYC-vR4_F\u0026q=85\u0026s=55e7a007be895bd849ab57c5f1b3b346"},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Join Community","icon":"globe","color":{"light":"#050021","dark":"#050021"},"href":"https://discord.gg/ng84Jm92tm"},{"anchor":"Download for Mac","icon":"download","color":{"light":"#F0A831","dark":"#F0A831"},"href":"https://modaal.dev/download"},{"anchor":"YouTube","hidden":true,"href":"https://www.youtube.com/@learningviaplay"}],"products":[{"product":"Demo","icon":"00","description":"Book a demo","hidden":true,"href":"https://modaal.dev/demo"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"modaal","hasAudioNarration":false,"actualSubdomain":"modaal","customDomains":["docs.modaal.dev"],"gitSource":{"type":"github","owner":"modaaldev","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad8682c77553aa7e94548e1","collectionId":"2febb69e-4967-4898-9ed2-481f78143a28","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad8682c77553aa7e94548e1"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ad8682c77553aa7e94548e1","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Guides","count":53},{"language":"default","tag":"Duet tutorials","count":10},{"language":"default","tag":"Duet framework","count":9},{"language":"default","tag":"Working with Modaal","count":8},{"language":"default","tag":"Duet comparisons","count":6},{"language":"default","tag":"Building for Android","count":4},{"language":"default","tag":"Overview","count":3},{"language":"default","tag":"Designing with AI","count":2},{"language":"default","tag":"Duet tutorials: Swift first","count":2},{"language":"default","tag":"FAQ","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":".sticky-col{border:1px solid rgba(3,7,18,.1);border-radius:12px;overflow:hidden;margin:1em 0}.sticky-col [data-table-wrapper]{margin:0;padding:0;width:100%}.sticky-col [data-table-wrapper]>div{padding-left:0;padding-right:0}.sticky-col table{border-collapse:separate;border-spacing:0;background-color:#fff}.sticky-col table td,.sticky-col table th{padding:10px 16px;border-bottom:1px solid rgba(3,7,18,.1);border-right:1px solid rgba(3,7,18,.1)}.sticky-col table td:last-child,.sticky-col table th:last-child{border-right:0}.sticky-col table tbody tr:last-child td,.sticky-col table tbody tr:last-child th{border-bottom:0}.sticky-col table td:first-child,.sticky-col table th:first-child{position:sticky;left:0;z-index:2;background-color:#fff}html.dark .sticky-col{border-color:rgba(255,255,255,.1)}html.dark .sticky-col table{background-color:#0d0a2e}html.dark .sticky-col table td,html.dark .sticky-col table th{border-bottom-color:rgba(255,255,255,.1);border-right-color:rgba(255,255,255,.1)}html.dark .sticky-col table td:first-child,html.dark .sticky-col table th:first-child{background-color:#0d0a2e}.scroll-code [data-component-part=code-block-root]{max-height:calc(.875rem + 20.5lh);overflow-y:auto;scrollbar-width:thin}"}],"page":{"pagePath":"guides/setup-xcode","slug":"/guides/setup-xcode","pageMetadata":{"title":"Set Up Xcode for Modaal: Install, Simulators, Verify","sidebarTitle":"Set up Xcode","icon":"wrench","description":"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup: the three steps before Modaal can build and run your iOS app.","keywords":["set up Xcode","install Xcode for Modaal","download iOS simulators","set up Xcode for building iOS apps","Xcode Attention needed Modaal","switch active Xcode version","Xcode setup guide Mac"],"og:title":"Set up Xcode for building iOS apps with Modaal","og:description":"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup — with fixes for the states the panel can show.","twitter:card":"summary_large_image","href":"/guides/setup-xcode"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup: the three steps before Modaal can build and run your iOS app.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,CodeBlock,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Xcode`}),` is Apple’s development environment for building and running iOS apps. Modaal drives it for you behind the scenes — you never have to write Swift in Xcode or wire up a project there. You just need it installed, opened once, and with the iOS simulators downloaded. Modaal does the rest. `,_jsx(_components.a,{href:`https://modaal.dev/compare/modaal-vs-xcode`,children:`What Modaal adds on top of Xcode`}),` is on modaal.dev.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`A Mac running macOS`,icon:`apple`,children:_jsx(_components.p,{children:`Xcode only runs on macOS. A reasonably recent Mac (Apple Silicon recommended) makes builds much faster.`})}),_jsx(Card,{title:`~50 GB of free disk space`,icon:`hard-drive`,children:_jsxs(_components.p,{children:[`Xcode plus the iOS simulators are large. Check under `,_jsx(_components.strong,{children:`→ System Settings → General → Storage`}),` and free up space first if you’re tight.`]})}),_jsx(Card,{title:`A stable internet connection`,icon:`wifi`,children:_jsx(_components.p,{children:`Xcode is a multi-gigabyte download, and the iOS simulators download separately on first launch. Plan for a coffee break.`})}),_jsx(Card,{title:`An Apple Account (optional)`,icon:`user`,children:_jsxs(_components.p,{children:[`You only need one to run on a `,_jsx(_components.strong,{children:`real iPhone`}),` or to publish to TestFlight / the App Store. The simulator needs nothing.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`open-the-xcode-setup-panel-in-modaal`,children:`Open the Xcode setup panel in Modaal`}),`\n`,_jsxs(_components.p,{children:[`Everything is driven from one place inside Modaal. Click your `,_jsx(_components.strong,{children:`profile avatar`}),` in the top-right corner to open the `,_jsx(_components.strong,{children:`User Menu`}),`, then choose `,_jsx(_components.strong,{children:`Set up Xcode`}),`.`]}),`\n`,_jsx(Frame,{caption:`User Menu → Set up Xcode. The colored dot shows your current status — green when Xcode is ready, orange when it still needs attention.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-0-user-menu.png?fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=3bc8e8059a7b24fb880450193b00af52`,alt:`Modaal User Menu with the Set up Xcode item highlighted`,style:{width:`300px`},\"data-og-width\":`231`,width:`231`,\"data-og-height\":`373`,height:`373`,\"data-path\":`images/xcode-setup-0-user-menu.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-0-user-menu.png?w=280\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=4cc4ea1581ca132df950098e0f2f4414 280w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-0-user-menu.png?w=560\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=258d55dcbcfaa9dc1f31487e1f37625a 560w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-0-user-menu.png?w=840\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=8734d7cfb415d85d30dd3c18a4321e15 840w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-0-user-menu.png?w=1100\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=64eab68aca9dec7bbda15ca8f120b893 1100w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-0-user-menu.png?w=1650\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=f33ef1a7d824f2415cf03172ccb17127 1650w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-0-user-menu.png?w=2500\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=3aebba0070e3ec63d7f108af60257e7a 2500w`})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Keep this panel open while you work through the steps below. After each step you’ll come back to it and press `,_jsx(_components.strong,{children:`Check`}),` / `,_jsx(_components.strong,{children:`Re-check`}),` to let Modaal re-detect your setup.`]})}),`\n`,_jsx(_components.p,{children:`The panel reports one of three states:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`What it means`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`🔴 `,_jsx(_components.strong,{children:`Not detected`})]}),_jsx(_components.td,{children:`Modaal can’t find any Xcode installation.`}),_jsxs(_components.td,{children:[`Install Xcode — `,_jsx(_components.a,{href:`#step-1`,children:`Step 1`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`🟠 `,_jsx(_components.strong,{children:`Attention needed`})]}),_jsx(_components.td,{children:`Xcode is installed, but it isn’t finished — usually the iOS simulators haven’t been downloaded yet.`}),_jsxs(_components.td,{children:[`Open Xcode and download simulators — `,_jsx(_components.a,{href:`#step-2`,children:`Step 2`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`🟢 `,_jsx(_components.strong,{children:`Installed`})]}),_jsx(_components.td,{children:`Xcode is installed, set up, and has iOS simulators. You’re ready to build.`}),_jsx(_components.td,{children:`Nothing — you’re done.`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`step-1`,children:`Step 1 — Install Xcode`}),`\n`,_jsxs(_components.p,{children:[`If the panel says `,_jsx(_components.strong,{children:`Not detected`}),`, Xcode isn’t installed yet.`]}),`\n`,_jsx(Frame,{caption:`“Not detected” — Xcode isn't installed. Download it from one of the two links shown.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-1-not-detected.png?fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=754fcfbd85c28169150a32bf377c3969`,alt:`Set up Xcode panel showing Not detected`,style:{width:`600px`},\"data-og-width\":`747`,width:`747`,\"data-og-height\":`591`,height:`591`,\"data-path\":`images/xcode-setup-1-not-detected.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-1-not-detected.png?w=280\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=2135f83f6b1461708b65b3b4d6ceebf0 280w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-1-not-detected.png?w=560\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=6220b32284c5d4b026be1269145222cf 560w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-1-not-detected.png?w=840\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=2c45eb38f25992b01439f2a4576156f4 840w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-1-not-detected.png?w=1100\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=f10c84b0329ab3539f2b89210649439b 1100w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-1-not-detected.png?w=1650\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=176a04e113e51baac46a57c246261193 1650w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-1-not-detected.png?w=2500\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=70138c1fc709d8bee23c51177df0e54e 2500w`})}),`\n`,_jsx(_components.p,{children:`Install Xcode from either source:`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Mac App Store`,icon:`apple`,href:`https://apps.apple.com/app/xcode/id497799835`,children:_jsxs(_components.p,{children:[`The easiest option. Search for `,_jsx(_components.strong,{children:`Xcode`}),`, click `,_jsx(_components.strong,{children:`Get`}),`, and it installs and updates automatically.`]})}),_jsx(Card,{title:`Apple Developer Program`,icon:`download`,href:`https://developer.apple.com/download/all/?q=xcode`,children:_jsx(_components.p,{children:`Download a specific Xcode version directly. Useful if you need an exact release. Sign in with a free Apple Account.`})})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Xcode is a large download (15+ GB) and can take a while to install — let it finish completely before moving on.`})}),`\n`,_jsxs(_components.p,{children:[`For the latest features — `,_jsx(_components.strong,{children:`iOS 26`}),`, the `,_jsx(_components.strong,{children:`Liquid Glass`}),` design system, and the newest simulators — install `,_jsx(_components.strong,{children:`Xcode 26 or newer`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`step-2`,children:`Step 2 — Open Xcode once and download the simulators`}),`\n`,_jsxs(_components.p,{children:[`This is the step that trips most people up. `,_jsx(_components.strong,{children:`Installing Xcode is not enough`}),` — you have to launch it once so it can finish its own setup and download the iOS simulators. Until you do, Modaal shows `,_jsx(_components.strong,{children:`Attention needed`}),`:`]}),`\n`,_jsx(Frame,{caption:`“Attention needed” — Xcode is installed (note the path and version), but Runtimes show “None” and there are no iOS Simulators yet.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-2-attention-needed.png?fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=35ec1b29aca80dc2e96cdc71c2878d8c`,alt:`Set up Xcode panel showing Attention needed with no simulators`,style:{width:`600px`},\"data-og-width\":`743`,width:`743`,\"data-og-height\":`585`,height:`585`,\"data-path\":`images/xcode-setup-2-attention-needed.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-2-attention-needed.png?w=280\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=5150f57211296d3302a784513c2360d2 280w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-2-attention-needed.png?w=560\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=09d2ec80c65b534f05cfd1c7b3196bc0 560w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-2-attention-needed.png?w=840\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=3ae63641fa7d1bfe19b7e027b0590413 840w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-2-attention-needed.png?w=1100\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=bf0670d11817633aeaa9fd26f82e9f8b 1100w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-2-attention-needed.png?w=1650\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=4e4d38c7d4e408420d5e0917e8e08e16 1650w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-2-attention-needed.png?w=2500\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=5bc7497f15eb4f4dd73c50ee704fcec5 2500w`})}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Launch Xcode and accept the license`,children:[_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Xcode`}),` from your Applications folder. The first time it runs, it asks you to agree to the `,_jsx(_components.strong,{children:`Xcode and Apple SDKs Agreement`}),`. Read it, then click `,_jsx(_components.strong,{children:`Agree`}),` (you’ll be asked for your Mac password).`]}),_jsx(Frame,{caption:`First launch asks you to accept the license agreement.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-3-license.png?fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=3848c9290ff6ba6132cfb72f0e5f6d6c`,alt:`Xcode and Apple SDKs Agreement dialog`,style:{width:`500px`},\"data-og-width\":`511`,width:`511`,\"data-og-height\":`445`,height:`445`,\"data-path\":`images/xcode-setup-3-license.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-3-license.png?w=280\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=075e90228cac3a1f0ec2e281bad1a239 280w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-3-license.png?w=560\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=cc81f37f42e1a01b687c6051a8193243 560w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-3-license.png?w=840\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=92f20c8552edaca3c262f78d38f8ad49 840w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-3-license.png?w=1100\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=4714fcde7fbe6060f49858bf5b112776 1100w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-3-license.png?w=1650\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=74a58535c475642bf5b506076c51c9ef 1650w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-3-license.png?w=2500\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=b2a1c7a59e0723e5b057e3eece3a8192 2500w`})})]}),_jsxs(Step,{title:`Choose the iOS platform and download it`,children:[_jsxs(_components.p,{children:[`Xcode then offers to install platform components. Make sure `,_jsx(_components.strong,{children:`iOS`}),` is checked and click `,_jsx(_components.strong,{children:`Download \u0026 Install`}),`. You can leave watchOS, tvOS, and visionOS unchecked — Modaal only needs `,_jsx(_components.strong,{children:`iOS`}),` to build and run iPhone apps.`]}),_jsx(Frame,{caption:`Tick iOS, then Download \u0026 Install. iOS is the only platform Modaal needs.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-4-components.png?fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=0e7d90dd4183f1c1ea30abb69c8c075a`,alt:`Xcode component selection with iOS checked`,style:{width:`440px`},\"data-og-width\":`507`,width:`507`,\"data-og-height\":`661`,height:`661`,\"data-path\":`images/xcode-setup-4-components.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-4-components.png?w=280\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=d138b1aa320ac8b0ecfd472724cfe80e 280w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-4-components.png?w=560\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=a1ef4292217acba12045f408b35cd51c 560w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-4-components.png?w=840\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=c84d576f2422a446d0465dd5b86179cf 840w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-4-components.png?w=1100\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=21ec28285bbc7c1ff0192dd325ee350d 1100w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-4-components.png?w=1650\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=50c68523998566db16f33bed486432fa 1650w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-4-components.png?w=2500\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=dd44ab7365eba1c708fdb1374d0a2b0b 2500w`})}),_jsx(Note,{children:_jsxs(_components.p,{children:[`If Xcode doesn’t show this screen on launch, you can trigger it any time from `,_jsx(_components.strong,{children:`Xcode → Settings… → Components`}),`, then download an `,_jsx(_components.strong,{children:`iOS`}),` simulator runtime.`]})})]}),_jsxs(Step,{title:`Wait for the simulator runtime to download`,children:[_jsxs(_components.p,{children:[`The iOS simulator runtime is several gigabytes and downloads in the background. You can watch progress in Xcode’s `,_jsx(_components.strong,{children:`Downloads`}),` window.`]}),_jsx(Frame,{caption:`The iOS simulator runtime downloading. Let it finish completely.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-5-download-progress.png?fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=329b32da622407f456f252071f218d11`,alt:`iOS simulator download in progress`,style:{width:`440px`},\"data-og-width\":`468`,width:`468`,\"data-og-height\":`566`,height:`566`,\"data-path\":`images/xcode-setup-5-download-progress.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-5-download-progress.png?w=280\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=77f7d90685810ced2b726cc12c8e3a65 280w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-5-download-progress.png?w=560\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=6189f32a923d2207d313a6c96008173d 560w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-5-download-progress.png?w=840\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=c7848fc97a2df3b4757c590c03e05a9c 840w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-5-download-progress.png?w=1100\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=f078de7c3ccffea80b912e66d180e564 1100w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-5-download-progress.png?w=1650\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=f0c52942e99c2e77f778dfd7b8af4d92 1650w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-5-download-progress.png?w=2500\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=236185644d93aae0004818acbde31756 2500w`})})]}),_jsxs(Step,{title:`Confirm it finished`,children:[_jsx(_components.p,{children:`When the download completes, the runtime shows a checkmark and Xcode opens its welcome window. Xcode is now fully set up.`}),_jsx(Frame,{caption:`Download complete — the iOS simulator runtime is installed.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-6-download-done.png?fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=7cdec89829bb68425b3d945775e94c39`,alt:`iOS simulator download complete, Xcode welcome window`,style:{width:`600px`},\"data-og-width\":`749`,width:`749`,\"data-og-height\":`470`,height:`470`,\"data-path\":`images/xcode-setup-6-download-done.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-6-download-done.png?w=280\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=ba2e7bf02aa61798d9370a7914ac24db 280w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-6-download-done.png?w=560\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=fc14ed99c0b08c62f4da130906d083f4 560w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-6-download-done.png?w=840\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=aff49e7f2a1de228854c7ae1e3954291 840w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-6-download-done.png?w=1100\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=616927e69dbde6da2314adcb4c10e99b 1100w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-6-download-done.png?w=1650\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=bad020cebd7a492e69ebad13f8182660 1650w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-6-download-done.png?w=2500\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=6a26834d6709d211e15b3f1e20e1c582 2500w`})}),_jsx(_components.p,{children:`You can quit Xcode now — Modaal launches it on its own when it needs to build.`})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`step-3`,children:`Step 3 — Re-check in Modaal`}),`\n`,_jsxs(_components.p,{children:[`Go back to Modaal’s `,_jsx(_components.strong,{children:`Set up Xcode`}),` panel and click `,_jsx(_components.strong,{children:`Re-check`}),`. Modaal probes your installation and, when everything’s in place, switches to `,_jsx(_components.strong,{children:`Installed`}),` (green) and lists the iOS simulators it found.`]}),`\n`,_jsx(Frame,{caption:`“Installed” — Xcode is set up with iOS simulators. You're ready to build and run.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-8-complete.png?fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=379acd55e1dfb7b67f639794e315613e`,alt:`Set up Xcode panel showing Installed and ready`,style:{width:`600px`},\"data-og-width\":`728`,width:`728`,\"data-og-height\":`557`,height:`557`,\"data-path\":`images/xcode-setup-8-complete.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-8-complete.png?w=280\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=0dd570cbc65f5403b80f5fb6f050d7af 280w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-8-complete.png?w=560\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=a4db236910d5b02667302292c17e441d 560w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-8-complete.png?w=840\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=5ff7f46f07bec01baab46a36f8d40a1c 840w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-8-complete.png?w=1100\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=1ef855c77c25bc58f46965ec05414f3e 1100w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-8-complete.png?w=1650\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=be8dbb24dde4fb1b4e5ab7b908c7490f 1650w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-8-complete.png?w=2500\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=71eb79e03faa96c76576ac16376e4a39 2500w`})}),`\n`,_jsx(_components.p,{children:`That’s it — you can now ask Modaal to build and run your app, and it’ll launch it on the iOS simulator for you.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`You can also re-validate from the User Menu via `,_jsx(_components.strong,{children:`Run system check`}),`, which re-checks Xcode along with Modaal’s other prerequisites.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`multiple-xcode`,children:`Have more than one Xcode installed?`}),`\n`,_jsxs(_components.p,{children:[`If you keep several Xcode versions (for example a stable release and a beta), Modaal lists each one and marks which is `,_jsx(_components.strong,{children:`active`}),` — the one macOS will use for builds. To switch, click `,_jsx(_components.strong,{children:`Set as active`}),` on the version you want.`]}),`\n`,_jsx(Frame,{caption:`With multiple Xcodes installed, click “Set as active” on the one you want Modaal to build with.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-7-set-as-active.png?fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=642421d33317feb41675474e711aadae`,alt:`An Xcode installation card with a Set as active button`,style:{width:`560px`},\"data-og-width\":`674`,width:`674`,\"data-og-height\":`269`,height:`269`,\"data-path\":`images/xcode-setup-7-set-as-active.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-7-set-as-active.png?w=280\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=dca98de5644f78f0f75ecb205e12d6bc 280w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-7-set-as-active.png?w=560\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=ad922a6864fd9e38dbc177318151698c 560w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-7-set-as-active.png?w=840\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=30f2244e9f7ecc957e18dca1f21927f7 840w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-7-set-as-active.png?w=1100\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=3304be19b818c1c926a7140c85b9022e 1100w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-7-set-as-active.png?w=1650\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=81bf9fb57b38ed92366deeb54c086f42 1650w, https://mintcdn.com/modaal/XlqSOtN6T6Qmy64H/images/xcode-setup-7-set-as-active.png?w=2500\u0026fit=max\u0026auto=format\u0026n=XlqSOtN6T6Qmy64H\u0026q=85\u0026s=3d89d309aed7fc175fc2e0580d8534b3 2500w`})}),`\n`,_jsxs(_components.p,{children:[`macOS asks for your administrator password to make the switch (it runs Apple’s `,_jsx(_components.code,{children:`xcode-select`}),` under the hood). If the button ever fails, the panel shows the exact command you can run yourself in `,_jsx(_components.strong,{children:`Terminal`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sudo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` xcode-select`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /path/to/Xcode.app/Contents/Developer`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Fix “Attention needed”, missing runtimes and Set as active`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Modaal still says “Attention needed” after installing Xcode`,id:`modaal-still-says-attention-needed-after-installing-xcode`,children:_jsxs(_components.p,{children:[`You almost certainly skipped `,_jsx(_components.a,{href:`#step-2`,children:`Step 2`}),`. Installing Xcode is not enough — open it once, accept the license, and download an `,_jsx(_components.strong,{children:`iOS`}),` simulator runtime from `,_jsx(_components.strong,{children:`Xcode → Settings… → Components`}),`. Then click `,_jsx(_components.strong,{children:`Re-check`}),` in Modaal.`]})}),_jsx(Accordion,{title:`“Runtimes: None” / no iOS Simulators listed`,id:`runtimes-none-no-ios-simulators-listed`,children:_jsxs(_components.p,{children:[`The simulator runtime hasn’t been downloaded. In Xcode, go to `,_jsx(_components.strong,{children:`Settings… → Components`}),`, download an `,_jsx(_components.strong,{children:`iOS`}),` runtime, wait for it to finish, then `,_jsx(_components.strong,{children:`Re-check`}),` in Modaal.`]})}),_jsx(Accordion,{title:`The build succeeded but no simulator window appeared`,id:`the-build-succeeded-but-no-simulator-window-appeared`,children:_jsxs(_components.p,{children:[`On recent Xcode versions the simulator viewer can’t launch when `,_jsx(_components.strong,{children:`Xcode is installed on an external or ownership-disabled volume`}),`. Move Xcode to your internal `,_jsx(_components.strong,{children:`/Applications`}),` folder, or re-enable ownership on the volume with `,_jsx(_components.code,{children:`sudo diskutil enableOwnership \u003cvolume>`}),`. The build itself still ran — this only affects showing the window.`]})}),_jsx(Accordion,{title:`“Set as active” keeps failing`,id:`set-as-active-keeps-failing`,children:_jsxs(_components.p,{children:[`Make sure you entered the correct `,_jsx(_components.strong,{children:`administrator`}),` password. As a fallback, copy the `,_jsx(_components.code,{children:`sudo xcode-select -s …`}),` command the panel shows and run it directly in `,_jsx(_components.strong,{children:`Terminal`}),`.`]})}),_jsx(Accordion,{title:`I'm running low on disk space`,id:`i-m-running-low-on-disk-space`,children:_jsxs(_components.p,{children:[`Xcode plus simulators can easily use 30–50 GB. Remove old simulator runtimes you don’t need from `,_jsx(_components.strong,{children:`Xcode → Settings… → Components`}),`, and check `,_jsx(_components.strong,{children:`→ System Settings → General → Storage`}),` for other large items.`]})})]}),`\n`,_jsxs(_components.p,{children:[`Xcode confirmed? Next: `,_jsx(_components.a,{href:`/guides/connect-your-agent`,children:`connect a coding agent`}),` if you have not yet, then `,_jsx(_components.a,{href:`/guides/quickstart`,children:`start your first project`}),`. TestFlight and App Store distribution need an Apple Developer account as well — `,_jsx(_components.a,{href:`https://modaal.dev/blog/apple-developer-account-setup`,children:`setting one up`}),` walks through the enrolment.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Still stuck?`}),` Join our `,_jsx(_components.a,{href:`https://discord.gg/ng84Jm92tm`,children:`community on Discord`}),` — we’re happy to help you get set up.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Set Up Xcode for Modaal: Install, Simulators, Verify","sidebarTitle":"Set up Xcode","icon":"wrench","description":"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup: the three steps before Modaal can build and run your iOS app.","keywords":["set up Xcode","install Xcode for Modaal","download iOS simulators","set up Xcode for building iOS apps","Xcode Attention needed Modaal","switch active Xcode version","Xcode setup guide Mac"],"og:title":"Set up Xcode for building iOS apps with Modaal","og:description":"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup — with fixes for the states the panel can show.","twitter:card":"summary_large_image","href":"/guides/setup-xcode"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Open the Xcode setup panel in Modaal","slug":"open-the-xcode-setup-panel-in-modaal","depth":2,"children":[]},{"title":"Step 1 — Install Xcode","slug":"step-1","depth":2,"children":[]},{"title":"Step 2 — Open Xcode once and download the simulators","slug":"step-2","depth":2,"children":[]},{"title":"Step 3 — Re-check in Modaal","slug":"step-3","depth":2,"children":[]},{"title":"Have more than one Xcode installed?","slug":"multiple-xcode","depth":2,"children":[]},{"title":"Fix “Attention needed”, missing runtimes and Set as active","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"modaal","siteName":"Modaal Docs","title":"Set up Xcode for building iOS apps with Modaal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-17T12:28:30.098Z","gitLastModified":"2026-09-17T12:28:01.000Z","originalFileLocation":"guides/setup-xcode.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup: the three steps before Modaal can build and run your iOS app.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Modaal Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Set up Xcode for building iOS apps with Modaal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup — with fixes for the states the panel can show.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Modaal Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.modaal.dev/guides/setup-xcode\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://modaal.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Set+Up+Xcode+for+Modaal%3A+Install%2C+Simulators%2C+Verify\u0026amp;description=Install+Xcode%2C+open+it+once+to+download+the+iOS+simulators%2C+and+let+Modaal+confirm+the+setup%3A+the+three+steps+before+Modaal+can+build+and+run+your+iOS+app.\u0026amp;theme=5bf34759321c8287037d3202\u0026amp;signature=001673aa5ab8ffda3edb70741d6b7afce51788f7bf8e842208762a3b9b8eb485\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Set up Xcode for building iOS apps with Modaal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup — with fixes for the states the panel can show.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://modaal.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Set+Up+Xcode+for+Modaal%3A+Install%2C+Simulators%2C+Verify\u0026amp;description=Install+Xcode%2C+open+it+once+to+download+the+iOS+simulators%2C+and+let+Modaal+confirm+the+setup%3A+the+three+steps+before+Modaal+can+build+and+run+your+iOS+app.\u0026amp;theme=5bf34759321c8287037d3202\u0026amp;signature=001673aa5ab8ffda3edb70741d6b7afce51788f7bf8e842208762a3b9b8eb485\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/modaal/dMgPx4Gc1jGsnyhU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Modaal Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F67AD0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.modaal.dev/guides/setup-xcode\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/setup-xcode.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://modaal.dev/#organization\",\"name\":\"Modaal\",\"url\":\"https://modaal.dev/\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/modaal/rBROILWhBGfA_4EY/logo/WhiteBg.svg?fit=max\u0026auto=format\u0026n=rBROILWhBGfA_4EY\u0026q=85\u0026s=02734f2e581ce4012a11be410fbfe02d\"},\"sameAs\":[\"https://www.linkedin.com/company/modaalagent/\",\"https://discord.gg/ng84Jm92tm\",\"https://www.reddit.com/r/modaal/\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.modaal.dev#website\",\"name\":\"Modaal Docs\",\"url\":\"https://docs.modaal.dev\",\"publisher\":{\"@id\":\"https://modaal.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.modaal.dev/guides/setup-xcode#webpage\",\"url\":\"https://docs.modaal.dev/guides/setup-xcode\",\"name\":\"Set Up Xcode for Modaal: Install, Simulators, Verify\",\"description\":\"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup: the three steps before Modaal can build and run your iOS app.\",\"dateModified\":\"2026-09-17T12:28:01.000Z\",\"isPartOf\":{\"@id\":\"https://docs.modaal.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.modaal.dev/guides/setup-xcode#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.modaal.dev/guides/setup-xcode#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.modaal.dev/guides/quickstart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Set Up Xcode for Modaal: Install, Simulators, Verify\",\"item\":\"https://docs.modaal.dev/guides/setup-xcode\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.modaal.dev/guides/setup-xcode#article\",\"headline\":\"Set Up Xcode for Modaal: Install, Simulators, Verify\",\"name\":\"Set Up Xcode for Modaal: Install, Simulators, Verify\",\"description\":\"Install Xcode, open it once to download the iOS simulators, and let Modaal confirm the setup: the three steps before Modaal can build and run your iOS app.\",\"url\":\"https://docs.modaal.dev/guides/setup-xcode\",\"mainEntityOfPage\":{\"@id\":\"https://docs.modaal.dev/guides/setup-xcode#webpage\"},\"dateModified\":\"2026-09-17T12:28:01.000Z\",\"keywords\":\"set up Xcode, install Xcode for Modaal, download iOS simulators, set up Xcode for building iOS apps, Xcode Attention needed Modaal, switch active Xcode version, Xcode setup guide Mac\",\"publisher\":{\"@id\":\"https://modaal.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.modaal.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Modaal Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Modaal Docs","nav":{"global":{"anchors":[{"anchor":"Join Community","icon":"globe","color":{"light":"#050021","dark":"#050021"},"href":"https://discord.gg/ng84Jm92tm"},{"anchor":"Download for Mac","icon":"download","color":{"light":"#F0A831","dark":"#F0A831"},"href":"https://modaal.dev/download"},{"anchor":"YouTube","hidden":true,"href":"https://www.youtube.com/@learningviaplay"}],"products":[{"product":"Demo","icon":"00","description":"Book a demo","hidden":true,"href":"https://modaal.dev/demo"}]},"tabs":[{"tab":"Guides","groups":[{"group":"Overview","pages":[{"title":"AI App Builder for Native iOS and Android Apps","sidebarTitle":"Welcome","icon":"hand-wave","href":"/welcome"},{"title":"Modaal Plans and Pricing: Free and Pro","sidebarTitle":"Plans \u0026 pricing","icon":"credit-card","href":"/credits-and-plans"},{"title":"Modaal Changelog: Releases and Updates","sidebarTitle":"Changelog","icon":"bolt-lightning","href":"/changelog"}]},{"group":"Guides","pages":[{"title":"Build Your First Native App with Modaal (iOS and Android)","sidebarTitle":"Quickstart","description":"Install Modaal, connect a coding agent, set up Xcode or the Android SDK, and go from a plain-language idea to a running native iOS or Android app.","icon":"rocket","href":"/guides/quickstart"},{"title":"Set Up Xcode for Modaal: Install, Simulators, Verify","sidebarTitle":"Set up Xcode","icon":"wrench","href":"/guides/setup-xcode"},{"title":"Set Up the Android Toolchain","sidebarTitle":"Set up Android","description":"What Modaal's install-the-Android-SDK banner means and what its button installs: the pinned SDK components, a user-local JDK, and your first emulator.","icon":"android","href":"/guides/setup-android"},{"title":"Connect Claude Code, Cursor, or Codex to Modaal","sidebarTitle":"Connect your agent","icon":"plug","href":"/guides/connect-your-agent"}]},{"group":"Working with Modaal","pages":[{"title":"Starting a New Project and Choosing the Right Template","sidebarTitle":"Starting a new project","icon":"block-brick","href":"/articles/new-project"},{"title":"Working with Modaal: A Guide to Modes and Prompts","sidebarTitle":"Modes and prompts","icon":"pen-nib","href":"/articles/modes-and-prompts"},{"title":"How to Add Firebase to an iOS App: Auth, Database, Analytics","sidebarTitle":"Firebase","icon":"fire","href":"/articles/firebase"},{"title":"Firebase Data Connect: A SQL Backend for Your iOS App","sidebarTitle":"Firebase Data Connect","icon":"database","href":"/articles/firebase-data-connect"},{"title":"Add In-App Purchases and Subscriptions to an iOS App","sidebarTitle":"In-app purchases \u0026 subscriptions","icon":"credit-card","href":"/articles/storekit-testing"},{"title":"Submit to the App Store Now, Stay iPhone Duo-Ready","sidebarTitle":"iPhone Duo: App Store prep","icon":"app-store-ios","href":"/guides/iphone-duo-app-store-submission"},{"title":"Debug Your App by Pointing at the Screen","sidebarTitle":"Visual debugging","icon":"eyes","href":"/articles/visual-debugging"},{"title":"Building 2D Games with SpriteKit","sidebarTitle":"2D games with SpriteKit","icon":"gamepad","href":"/articles/spritekit-games"}]},{"group":"Duet framework","icon":"mobile-screen","pages":[{"title":"Duet Framework Documentation Map","sidebarTitle":"Duet home","icon":"house","href":"/duet"},{"title":"The Duet Framework: One Shared Core, Two Native Apps","sidebarTitle":"Duet overview","icon":"mobile-screen-button","href":"/articles/duet"},{"title":"Duet Twins: a Swift Core for iPhone, a Kotlin Core for Android","sidebarTitle":"Duet Twins","tag":"Preview","icon":"code-compare","href":"/articles/duet-twins"},{"title":"Should You Share Code Between iOS and Android?","sidebarTitle":"Should you share code?","icon":"share-nodes","href":"/articles/share-code-ios-android"},{"title":"Handling Platform-Specific UI on iOS and Android","sidebarTitle":"Platform-specific UI","icon":"layer-group","href":"/articles/cross-platform-ui-parity"},{"title":"The Structure of a Kotlin Multiplatform iPhone App","sidebarTitle":"Inside a Duet iPhone app","icon":"apple","href":"/articles/duet-ios-app-anatomy"},{"title":"Kotlin/Native GC and Swift ARC in One iPhone App","sidebarTitle":"Kotlin GC and Swift ARC","icon":"memory","href":"/articles/kotlin-native-gc-swift-arc"},{"title":"Migrating a CombineRIBs App to Duet","sidebarTitle":"CombineRIBs to Duet","icon":"arrow-right-arrow-left","href":"/articles/combineribs-to-duet"},{"title":"Duet Glossary: Every Term in the Cross-Platform Framework","sidebarTitle":"Glossary","icon":"book","href":"/articles/duet-glossary"}]},{"group":"Duet tutorials","icon":"graduation-cap","pages":[{"title":"Kotlin Multiplatform Tutorial Series: Duet in Nine Steps","sidebarTitle":"Tutorials overview","icon":"graduation-cap","href":"/tutorials/duet"},{"title":"Duet Tutorial 1: Your First Feature","sidebarTitle":"Tutorial 1: Your first feature","icon":"play","href":"/tutorials/duet-01-first-feature"},{"title":"Duet Tutorial 2: One Behavior, Two Apps","sidebarTitle":"Tutorial 2: One behavior, two apps","icon":"mobile-screen-button","href":"/tutorials/duet-02-two-apps"},{"title":"Duet Tutorial 3: Composing Features","sidebarTitle":"Tutorial 3: Composing features","icon":"sitemap","href":"/tutorials/duet-03-composing-features"},{"title":"Duet Tutorial 4: Workers","sidebarTitle":"Tutorial 4: Workers","icon":"gears","href":"/tutorials/duet-04-workers"},{"title":"Duet Tutorial 5: Navigation as State","sidebarTitle":"Tutorial 5: Navigation as state","icon":"signs-post","href":"/tutorials/duet-05-navigation-as-state"},{"title":"Duet Tutorial 6: The Checks in CI","sidebarTitle":"Tutorial 6: The checks in CI","icon":"list-check","href":"/tutorials/duet-06-checks-in-ci"},{"title":"Duet Tutorial 7: Theming with Design Tokens","sidebarTitle":"Tutorial 7: Theming with design tokens","icon":"palette","href":"/tutorials/duet-07-theming"},{"title":"Duet Tutorial 8: Localizing the App","sidebarTitle":"Tutorial 8: Localizing the app","icon":"language","href":"/tutorials/duet-08-localization"},{"title":"Duet Tutorial 9: Adding Analytics","sidebarTitle":"Tutorial 9: Adding analytics","icon":"chart-line","href":"/tutorials/duet-09-analytics"}]},{"group":"Duet tutorials: Swift first","icon":"swift","pages":[{"title":"Duet Swift Tutorial 1: Your First Feature","sidebarTitle":"Swift 1: your first feature","icon":"play","href":"/tutorials/duet-swift-01-first-feature"},{"title":"Duet Twins Tutorial 2: One Behavior, Two Cores","sidebarTitle":"Twins 2: one behavior, two cores","icon":"code-compare","href":"/tutorials/duet-twins-02-two-cores"}]},{"group":"Duet comparisons","icon":"scale-balanced","pages":[{"title":"The Best Cross-Platform Frameworks in 2026","sidebarTitle":"Best cross-platform frameworks","icon":"map","href":"/articles/best-cross-platform-framework"},{"title":"Duet vs Flutter: Native UI vs One Codebase","sidebarTitle":"Duet vs Flutter","icon":"code-compare","href":"/articles/duet-vs-flutter"},{"title":"Duet vs React Native: Shared Logic, No JS Runtime","sidebarTitle":"Duet vs React Native","icon":"atom","href":"/articles/duet-vs-react-native"},{"title":"Duet vs Compose Multiplatform: Share Logic or Share UI?","sidebarTitle":"Duet vs Compose Multiplatform","icon":"clone","href":"/articles/duet-vs-compose-multiplatform"},{"title":"Duet vs Ionic Capacitor: Native UI or a Web View?","sidebarTitle":"Duet vs Ionic Capacitor","icon":"globe","href":"/articles/duet-vs-ionic-capacitor"},{"title":"Best iOS App Architecture: TCA, RIBs, VIPER, MVVM, Clean","sidebarTitle":"iOS architectures compared","icon":"sitemap","href":"/articles/best-ios-app-architecture"}]},{"group":"Building for Android","icon":"android","pages":[{"title":"How Android Apps Work: Anatomy of a Modern Android App","sidebarTitle":"How Android apps work","icon":"cubes","href":"/articles/how-android-apps-work"},{"title":"Android API Levels: Versions, Codenames, and Device Coverage","sidebarTitle":"Android API levels","icon":"table","href":"/articles/android-api-levels"},{"title":"The Structure of a Kotlin Multiplatform Android App","sidebarTitle":"Inside a Duet Android app","icon":"folder-tree","href":"/articles/duet-android-app-anatomy"},{"title":"How to Build Testable Android Apps: What Duet Fixes in Place","sidebarTitle":"Testable Android apps","icon":"vial-circle-check","href":"/articles/testable-android-apps"}]},{"group":"Designing with AI","icon":"paint-brush","pages":[{"title":"How to Design an App with AI: Screenshots to Design System","sidebarTitle":"Design your app with a design system","icon":"palette","href":"/ai-design"},{"title":"AI Design Prompts for App UI: Spacing, Contrast, and Polish","sidebarTitle":"Design prompts that work","icon":"wand-magic-sparkles","href":"/design-prompts"}]},{"group":"FAQ","pages":[{"title":"Modaal FAQ: Common Questions About Building Apps with AI","sidebarTitle":"FAQ","icon":"question","href":"/faq"}]},{"group":"Tutorial videos","hidden":true,"expanded":true,"pages":[]}]},{"tab":"Book a demo","icon":"angles-right","href":"https://calendly.com/modaal","global":{"products":[]}}]},"title":"Set up Xcode for building iOS apps with Modaal","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-DYplxqhs.js","DynamicMarkdown-Cc6AuSHS.js","zoom-image-lightbox-BNnMwe0F.js","lightbox-handle-r17bVUz3.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}
.svg?fit=max&auto=format&n=rBROILWhBGfA_4EY&q=85&s=0185f3e9df88428c430b0b130b94d569)
