Koda user guide
From an idea to an iOS app.
Plain-language, step-by-step help for every part of Koda-written for builders, not programmers.
Describe what you want
Review Koda’s plan
Test it in the simulator
Refine, then publish
Choose your path
What would you like to do?
Your first hour
A simple path from install to publish.
Follow these five guides in order the first time you use Koda. Skip ahead later when you only need one topic.
- 01
Set up Koda
Complete the guided setup, sign in, and save an AI provider key.
- 02
Create an app
Describe an idea on Home, or create a project from Apps. Connect a backend if the app needs sign-in or shared data.
- 03
Develop your app
Use chat, the App Roadmap, and the Environment menu to build and preview the first feature.
- 04
Koda Agents
Learn how the Supervisor and Xcode agent use the App Roadmap and task plan.
- 05
Ship when ready
Archive, validate, and upload to App Store Connect.
Complete reference
Every page, explained.
Follow Koda’s interface from creating an app through connecting a backend, adding services, and sending a build to Apple.
Set up Koda
Open Koda and follow a short guided setup. Koda walks you through one step at a time so your Mac is ready to build and preview apps.
Create and manage apps
Create a new iOS app from Home or from Apps, open an existing Xcode project, and reopen recent work from your project library.
Set up the project backend
Open Project Setup to pick a backend (Supabase, AWS, or Google Cloud), keep secrets in the cloud instead of the iPhone app, and connect services such as Shopify. The same runtime protocol works for every provider.
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.
Koda Agents
Koda builds with two agents: a Supervisor that plans and reviews, and an Xcode agent that implements changes in your project. Together they work from the project App Roadmap and, when needed, a short Current Work Plan for the chat at hand.
Connect cloud accounts
Connect Supabase, Google Cloud, or AWS in Integrations so Project Setup can link a backend. Credentials stay on this Mac and are never written into generated Swift.
Deploy your app
Connect Apple Developer, then turn the current Xcode project into a signed IPA, validate it with Apple, and upload it to App Store Connect.
Review past chats
Reopen earlier conversations from the sidebar so you can continue work with the same chat context.
Add an AI provider key
Save one OpenAI or Anthropic API key locally so Koda can plan, write, and revise your app. You only need one provider-not both.
Manage your profile
Review the account currently signed in to Koda, update its display name, and end the session safely.