KKodaGuide
Guide/Develop your app

Core workflow

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.

01

Know the workspace

  • The left sidebar switches projects, pages, and chat sessions. Its width and collapsed state stay put as you move between pages-no flicker on the way.
    Opening a project in chat loads the builder workspace with navigation, chat, the App Roadmap, and preview in one place.
  • Use chat to describe a feature, answer questions from the agents, and guide the agents as they work. You can choose the provider and model you'd like to power the agents with from the dropdowns.
    The dropdowns under chat let you choose the LLM provider and model.
  • 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.
02

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/4 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.

03

Configure the Environment

  • Open Environment from the project ribbon. A short Project/Simulator menu walks through three steps: where to launch, Apple signing, and Build and launch.
    Environment is a three-step menu: pick a simulator or connected device, confirm Apple signing, then Build and launch.
  • At the top, set Agent mode to Supervisor + Xcode or Xcode Agent Only. See Koda Agents for how those roles fit together.
  • In 1. Pick a place to launch your app, choose iPhone/iPad Simulator or Connected Device. For a simulator, pick one from the list, then Use this simulator or Start simulator.
  • For a connected iPhone or iPad, unlock the device, keep it plugged in, and choose it under Connected Device. Console and crash logs from that launch stream to the agent the same way simulator logs do. Starting a new launch stops the previous log stream.
  • In 2. Apple signing, pick a development team when you run on a real device. Teams come from Xcode on this Mac. You can also set the team from Set up the project backend.
  • In 3. Run your app, select Build and launch. While agents are working, use Stop to cancel the run or Reset context if you want a clean start-those controls stay correct during an active task.
04

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.

05

Preview and code controls

  • Change or start the simulated device from Environment, not from a separate activity list.
  • 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.
  • If a provider is out of credits or billing is off, Koda shows a billing or quota message instead of a generic rate-limit error. Open that provider’s billing page, then retry.