Before writing any code, 10x researches your concept, asks clarifying questions, and creates a detailed project plan — all in plan mode.
Plan mode is the first phase of every new 10x project. The AI acts as a product strategist and researcher: it studies your idea, looks at similar apps, asks you focused questions, and produces a structured project plan. No Swift code is written during this phase — the goal is to make sure the AI understands exactly what to build before it starts.
When the AI needs your input during planning, it pauses and presents one to four questions directly in the chat panel. Questions typically cover things like:
The app’s core purpose and target audience
Which features belong in the first version
Design preferences or references
The app’s name
Questions often include suggested answers you can tap to select. Some questions allow multiple selections — for example, when choosing which features to include in v1.
1
Read the questions
When the AI asks questions, they appear as an inline card in the chat. Each question may have selectable options listed below it.
2
Answer each question
Click an option to select it, or type a freeform answer in the text field provided. For multi-select questions, you can pick more than one option.
3
Submit your answers
Click Submit (or press Enter) to send your answers back to the AI. It continues planning based on your responses.
The AI batches related questions into a single ask rather than asking one at a time. You’ll typically see two to four questions together covering product vision, features, and design direction.
Once the AI finishes planning and you’re satisfied with the plan, it will transition to build mode automatically — or prompt you to confirm the direction and start building. You can also send a follow-up message like “looks good, start building” to move things forward if the AI is waiting for confirmation.
You can edit or refine the plan by sending messages in chat while still in plan mode. Ask the AI to change the feature scope, adjust the design direction, or reconsider the architecture before any code is written.
Be specific in your initial prompt. The more detail you provide upfront — the core problem, target user, and any must-have features — the fewer clarifying questions the AI needs to ask. A prompt like “A habit tracker with daily streaks, weekly stats, and push reminders for busy professionals” gives the AI much more to work with than “habit app.”Answer clarifying questions thoughtfully. The AI uses your answers to shape the entire project: screen layout, data model, design style, and more. Taking a moment to give considered answers leads to a first build that’s closer to what you actually want.Keep the MVP scope tight. The AI will suggest a focused first version — usually three to five core screens. Resist the temptation to add everything at once. You can always send follow-up messages in build mode to add features later.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"10x","colors":{"primary":"#33B93E","light":"#24872D","dark":"#33B93E"},"logo":"https://mintcdn.com/10x-58a4554c/K8KakeV-gb1CgaTM/images/icon.svg?fit=max\u0026auto=format\u0026n=K8KakeV-gb1CgaTM\u0026q=85\u0026s=6a65604ba21b45bfd02426a217cc8c62","favicon":"https://mintcdn.com/10x-58a4554c/K8KakeV-gb1CgaTM/images/icon.svg?fit=max\u0026auto=format\u0026n=K8KakeV-gb1CgaTM\u0026q=85\u0026s=6a65604ba21b45bfd02426a217cc8c62","appearance":{"default":"dark"},"navbar":{"primary":{"type":"github","href":"https://github.com/10x-app-builder/10x"}},"fonts":{"family":"Inter"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"10x-58a4554c","hasAudioNarration":false,"actualSubdomain":"10x-58a4554c","customDomains":["docs.10x.app"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-10x-58a4554c-453e3f26","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae95601f74cc9f20f4efea7:success","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Documentation","count":16},{"language":"default","tag":"Building Apps","count":5},{"language":"default","tag":"Account \u0026 Billing","count":3},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Preview \u0026 Files","count":3},{"language":"default","tag":"Integrations","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"building/plan-mode","slug":"/building/plan-mode","pageMetadata":{"title":"Plan mode: AI research and project planning","description":"Before writing any code, 10x researches your concept, asks clarifying questions, and creates a detailed project plan — all in plan mode.","href":"/building/plan-mode"},"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: \"Before writing any code, 10x researches your concept, asks clarifying questions, and creates a detailed project plan — all in plan mode.\"\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={li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,Step,Steps,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Plan mode is the first phase of every new 10x project. The AI acts as a product strategist and researcher: it studies your idea, looks at similar apps, asks you focused questions, and produces a structured project plan. No Swift code is written during this phase — the goal is to make sure the AI understands exactly what to build before it starts.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-happens-in-plan-mode`,children:`What happens in plan mode`}),`\n`,_jsx(_components.p,{children:`When you submit a prompt, the AI immediately begins working in plan mode. It:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Reviews your description and checks it against what 10x can build.`}),`\n`,_jsx(_components.li,{children:`Researches similar apps, relevant Apple Human Interface Guidelines, and any needed documentation.`}),`\n`,_jsx(_components.li,{children:`Asks you clarifying questions inline in the chat (see below).`}),`\n`,_jsx(_components.li,{children:`Produces a project plan that includes the app concept, target audience, core features, screen map, design direction, and technical architecture.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The plan appears in the `,_jsx(_components.strong,{children:`Plan`}),` tab in the preview panel on the right side of the workspace. It updates as the AI refines its thinking.`]}),`\n`,_jsx(Heading,{level:`2`,id:`answering-inline-questions`,children:`Answering inline questions`}),`\n`,_jsx(_components.p,{children:`When the AI needs your input during planning, it pauses and presents one to four questions directly in the chat panel. Questions typically cover things like:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The app’s core purpose and target audience`}),`\n`,_jsx(_components.li,{children:`Which features belong in the first version`}),`\n`,_jsx(_components.li,{children:`Design preferences or references`}),`\n`,_jsx(_components.li,{children:`The app’s name`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Questions often include suggested answers you can tap to select. Some questions allow multiple selections — for example, when choosing which features to include in v1.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Read the questions`,children:_jsx(_components.p,{children:`When the AI asks questions, they appear as an inline card in the chat. Each question may have selectable options listed below it.`})}),_jsx(Step,{title:`Answer each question`,children:_jsx(_components.p,{children:`Click an option to select it, or type a freeform answer in the text field provided. For multi-select questions, you can pick more than one option.`})}),_jsx(Step,{title:`Submit your answers`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Submit`}),` (or press `,_jsx(_components.strong,{children:`Enter`}),`) to send your answers back to the AI. It continues planning based on your responses.`]})})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`The AI batches related questions into a single ask rather than asking one at a time. You’ll typically see two to four questions together covering product vision, features, and design direction.`})}),`\n`,_jsx(Heading,{level:`2`,id:`advancing-to-build-mode`,children:`Advancing to build mode`}),`\n`,_jsx(_components.p,{children:`Once the AI finishes planning and you’re satisfied with the plan, it will transition to build mode automatically — or prompt you to confirm the direction and start building. You can also send a follow-up message like “looks good, start building” to move things forward if the AI is waiting for confirmation.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`You can edit or refine the plan by sending messages in chat while still in plan mode. Ask the AI to change the feature scope, adjust the design direction, or reconsider the architecture before any code is written.`})}),`\n`,_jsx(Heading,{level:`2`,id:`tips-for-better-results`,children:`Tips for better results`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Be specific in your initial prompt.`}),` The more detail you provide upfront — the core problem, target user, and any must-have features — the fewer clarifying questions the AI needs to ask. A prompt like “A habit tracker with daily streaks, weekly stats, and push reminders for busy professionals” gives the AI much more to work with than “habit app.”`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Answer clarifying questions thoughtfully.`}),` The AI uses your answers to shape the entire project: screen layout, data model, design style, and more. Taking a moment to give considered answers leads to a first build that’s closer to what you actually want.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Keep the MVP scope tight.`}),` The AI will suggest a focused first version — usually three to five core screens. Resist the temptation to add everything at once. You can always send follow-up messages in build mode to add features later.`]})]})}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":"Plan mode: AI research and project planning","description":"Before writing any code, 10x researches your concept, asks clarifying questions, and creates a detailed project plan — all in plan mode.","href":"/building/plan-mode"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What happens in plan mode","slug":"what-happens-in-plan-mode","depth":2,"children":[]},{"title":"Answering inline questions","slug":"answering-inline-questions","depth":2,"children":[]},{"title":"Advancing to build mode","slug":"advancing-to-build-mode","depth":2,"children":[]},{"title":"Tips for better results","slug":"tips-for-better-results","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"10x-58a4554c","siteName":"10x","title":"Plan mode: AI research and project planning - 10x","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-27T17:19:49.223Z","originalFileLocation":"building/plan-mode.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=\"dark\"}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=\"Before writing any code, 10x researches your concept, asks clarifying questions, and creates a detailed project plan — all in plan mode.\">\u003cmeta data-mint-head name=\"application-name\" content=\"10x\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/10x-58a4554c/vJ3RFigG6lX3Ioah/_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/10x-58a4554c/vJ3RFigG6lX3Ioah/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/10x-58a4554c/vJ3RFigG6lX3Ioah/_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/10x-58a4554c/vJ3RFigG6lX3Ioah/_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/10x-58a4554c/vJ3RFigG6lX3Ioah/_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/10x-58a4554c/vJ3RFigG6lX3Ioah/_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/10x-58a4554c/vJ3RFigG6lX3Ioah/_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/10x-58a4554c/vJ3RFigG6lX3Ioah/_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/10x-58a4554c/vJ3RFigG6lX3Ioah/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Plan mode: AI research and project planning - 10x\">\u003cmeta data-mint-head property=\"og:description\" content=\"Before writing any code, 10x researches your concept, asks clarifying questions, and creates a detailed project plan — all in plan mode.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"10x\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.10x.app/building/plan-mode\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://10x-58a4554c.mintlify.site/_mintlify/api/og/v2?division=Building+Apps\u0026amp;title=Plan+mode%3A+AI+research+and+project+planning\u0026amp;description=Before+writing+any+code%2C+10x+researches+your+concept%2C+asks+clarifying+questions%2C+and+creates+a+detailed+project+plan+%E2%80%94+all+in+plan+mode.\u0026amp;theme=5553c5c2402035485119d4bc\u0026amp;signature=32cb2d0bb611ecb17fd0814ff76c141321f02e182849672ee2225efb7369ca26\">\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=\"Plan mode: AI research and project planning - 10x\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Before writing any code, 10x researches your concept, asks clarifying questions, and creates a detailed project plan — all in plan mode.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://10x-58a4554c.mintlify.site/_mintlify/api/og/v2?division=Building+Apps\u0026amp;title=Plan+mode%3A+AI+research+and+project+planning\u0026amp;description=Before+writing+any+code%2C+10x+researches+your+concept%2C+asks+clarifying+questions%2C+and+creates+a+detailed+project+plan+%E2%80%94+all+in+plan+mode.\u0026amp;theme=5553c5c2402035485119d4bc\u0026amp;signature=32cb2d0bb611ecb17fd0814ff76c141321f02e182849672ee2225efb7369ca26\">\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/10x-58a4554c/vJ3RFigG6lX3Ioah/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"10x\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#33B93E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.10x.app/building/plan-mode\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/building/plan-mode.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.10x.app/#organization\",\"name\":\"10x\",\"url\":\"https://docs.10x.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/10x-58a4554c/K8KakeV-gb1CgaTM/images/icon.svg?fit=max\u0026auto=format\u0026n=K8KakeV-gb1CgaTM\u0026q=85\u0026s=6a65604ba21b45bfd02426a217cc8c62\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.10x.app#website\",\"name\":\"10x\",\"url\":\"https://docs.10x.app\",\"publisher\":{\"@id\":\"https://docs.10x.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.10x.app/building/plan-mode#webpage\",\"url\":\"https://docs.10x.app/building/plan-mode\",\"name\":\"Plan mode: AI research and project planning\",\"description\":\"Before writing any code, 10x researches your concept, asks clarifying questions, and creates a detailed project plan — all in plan mode.\",\"dateModified\":\"2026-04-27T17:19:49.223Z\",\"isPartOf\":{\"@id\":\"https://docs.10x.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.10x.app/building/plan-mode#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.10x.app/building/plan-mode#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Building Apps\",\"item\":\"https://docs.10x.app/building/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Plan mode: AI research and project planning\",\"item\":\"https://docs.10x.app/building/plan-mode\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.10x.app/building/plan-mode#article\",\"headline\":\"Plan mode: AI research and project planning\",\"name\":\"Plan mode: AI research and project planning\",\"description\":\"Before writing any code, 10x researches your concept, asks clarifying questions, and creates a detailed project plan — all in plan mode.\",\"url\":\"https://docs.10x.app/building/plan-mode\",\"mainEntityOfPage\":{\"@id\":\"https://docs.10x.app/building/plan-mode#webpage\"},\"dateModified\":\"2026-04-27T17:19:49.223Z\",\"publisher\":{\"@id\":\"https://docs.10x.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.10x.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"10x\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"10x","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"10x: build iOS apps with AI in plain language","href":"/introduction"},{"title":"Quickstart: build your first iOS app with 10x","href":"/quickstart"},{"title":"Install 10x on macOS: requirements and setup","href":"/installation"}]},{"group":"Building Apps","pages":[{"title":"How 10x turns your idea into a running iOS app","description":"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.","href":"/building/overview"},{"title":"Plan mode: AI research and project planning","href":"/building/plan-mode"},{"title":"Build mode: AI writes and edits your SwiftUI code","description":"In build mode, 10x writes and edits Swift files using an agentic tool loop — watch progress live in the chat panel and iterate with follow-up messages.","href":"/building/build-mode"},{"title":"Customize your app's design style and audience","href":"/building/design-styles"},{"title":"Attach files and images to your app prompt","href":"/building/attachments"}]},{"group":"Preview \u0026 Files","pages":[{"title":"Preview your iOS app on the iPhone Simulator","href":"/preview/simulator-preview"},{"title":"Browse and view your generated Swift project files","href":"/preview/file-explorer"},{"title":"Open your 10x-generated iOS project in Xcode","href":"/preview/open-in-xcode"}]},{"group":"Integrations","pages":[{"title":"Add a Supabase backend to your 10x iOS app","href":"/integrations/supabase"},{"title":"Configure environment variables for your app","href":"/integrations/environment-variables"}]},{"group":"Account \u0026 Billing","pages":[{"title":"Sign in to 10x and complete account setup","href":"/account/sign-in"},{"title":"Manage your 10x subscription, plans, and credits","href":"/account/billing"},{"title":"View your AI credit balance and usage history","href":"/account/usage"}]}]}]},"basePath":"","title":"Plan mode: AI research and project planning - 10x","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":[],"chunks":[]}