Develop your app

Use chat, the App Roadmap, the live simulator, and the code view together to turn plain-language requests into a working iOS app.

Know the workspace

The left sidebar switches projects, pages, and chat sessions.
Opening a project in chat loads the builder workspace with navigation, chat, project context, and preview in one place.
The conversation area is where you explain a feature, answer Koda’s questions, and follow the implementation plan.
The preview area streams the selected iOS Simulator. Drag the divider to give chat or preview more room.
Preview shows the running app; Code lets you browse, search, edit, and save project files.
Switch to Code when you need to inspect project files, search, edit, or save changes directly.

Use the App Roadmap

The App Roadmap is the project-level build plan: an ordered list of requirements and work steps for the app. It appears at the top of the chat column in the builder, below the project ribbon. The Supervisor uses it as a task queue—working through one step at a time, updating each item’s status, and deciding when a step is done.

Expand or collapse the panel from its header. You’ll see the current focus step, a progress count such as 0/8 complete, and each step’s status.
The App Roadmap lists the build steps for the app. Expand it to review status and progress; the Supervisor updates these as work moves forward.
As agents work, step statuses move through values such as Pending, In progress, Awaiting review, Deferred, Needs revision, and Done.
Select Edit to open Shape the app roadmap. Reorder steps with the drag handle, rename a step, mark it Pending or Complete, remove a step, or use Add a step to append work.
Use Edit to reorder, rename, mark Pending or Complete, add, or remove steps. Changes save automatically to the project’s build plan.
Choose Done when you finish editing. Changes save automatically to the project’s build plan, and the Supervisor follows the updated roadmap on later work.

Good to knowSome chats also show a separate Current Work Plan for short, tactical sub-steps in that conversation. That plan is read-only and is not the same as the project App Roadmap.

Configure the Environment

Open Environment from the top of the builder workspace to configure the run settings Koda will use for chat, builds, and launches. Project Path and Scheme load automatically from the project you opened in chat.
The Environment panel centralizes destination, signing, and launch settings. Project Path and Scheme are filled in automatically for the open project.
Choose which agents handle the work. Supervisor + Xcode uses the Supervisor agent to plan, delegate specific tasks to the Xcode agent, and review that work. Xcode Agent Only sends tasks straight to the Xcode agent. See Koda Agents for how those roles and plans fit together.
Choose a Run Destination. Simulator mode lets you pick a simulator, Set Active, or Boot it. Physical Device mode is for a connected and trusted iPhone or iPad—unlock the device, keep it plugged in, and confirm it appears under Physical Device before you Launch.
Select the Development Team and Bundle ID when signing matters, especially for physical-device builds. You can also set the team from Connect external services on the app’s settings page.
Use Launch to run the selected app or Build to compile it. The Activity list confirms discovered schemes, loaded simulators, physical devices, and other environment updates.

Manage conversations

Start a new chat when you begin a separate feature or the current conversation has become too broad.
Use the CHATS list in the sidebar to reopen an earlier conversation.
Delete a chat only when you no longer need its messages or build history.

Good to knowA new chat gives Koda a clean working context; it does not delete your project files. Agent roles and plans are explained in Koda Agents.

Preview and code controls

Change the simulated device from the device menu.
Zoom the preview when you need a closer look, or open it full screen.
In Code, expand folders, search filenames or contents, select a file, make an edit, and save. Unsaved files are marked.
Use the simulator controls to start, stop, or refresh the selected app when the preview is stale.