Set up the project backend

Open Project Setup

1. 1

   From Apps, open the project’s settings (the cog on the project card).

2. 2

   From a chat, use the gear in the project ribbon, then Project Settings.

3. 3

   The page is titled Project Setup. It walks you through a backend, then the APIs this app needs.

   

Choose a backend

Under Backend, pick where Koda should store app data, protected credentials, and service connections. Every option uses the same runtime protocol. Generated Swift never embeds cloud secrets-the iPhone app only calls the public function URL.

1. 1

   If no backend is linked yet, read Where should Koda store app data and secrets? and choose a provider.

   

2. 2

   Choose Supabase if you want Koda to create and manage the backend for you. This is the recommended path for beginners.

3. 3

   Choose Google Cloud to deploy the runtime and secrets into a Google Cloud project you already use.

4. 4

   Choose AWS to deploy the runtime and secrets into an AWS account and region you choose.

5. 5

   Choose Custom HTTP only if your team hosts and maintains its own runtime.

Create or connect Supabase

With Supabase selected, you can create a new project or link one you already have. Connect Supabase in Connect cloud accounts first if the amber banner asks you to.

1. 1

   Keep Create new selected to start a project, or switch to Use existing to pick one from the list.

2. 2

   For a new project, confirm the Supabase project name (it starts from your Xcode project name).

3. 3

   Enter a Database password. You set this once. Save it somewhere safe-Koda will not ask for it again, but you may want it later for use in other applications.

   

4. 4

   Select Create & Link Project. For an existing project, choose it from the list and select Link Project.

Link Google Cloud or AWS

Google Cloud and AWS use the credentials you saved in Connect cloud accounts. This page only stores a project or account link-not the keys.

1. 1

   Select Google Cloud or AWS in the backend picker.

   

2. 2

   If you see an amber banner, open Integrations, connect that provider, then return here.

3. 3

   For Google Cloud, choose a Google Cloud project and select Link Project.

4. 4

   For AWS, choose an AWS account and Region, then select Link Account.

   

5. 5

   When you later select Save setup on a Google Cloud project, Koda may ask Where should Koda save your data? Choose Use an existing database or Create a new database, then Continue. That Firestore database stores login info and service settings for this app.

Connect an API or service

Under Connected Services, add the APIs this app needs. Koda keeps secret values protected and sends requests through your backend. The iPhone app never receives those secrets.

1. 1

   Scroll to Connected Services. Leave Test service connections after save checked so Koda verifies the proxy after you save.

2. 2

   To use a preset, choose a provider under Explore presets (for example Shopify). To configure any other API yourself, select Custom Service.

   

3. 3

   For a custom service, enter a plain name and description, add the fields the service needs, and mark passwords, tokens, and private values as Secret value.

4. 4

   Choose API key or OAuth 2.0, set the API base URL, and map credential fields or headers as needed.

5. 5

   Select Save setup (or Save & verify proxy) before asking the agent to use the service.

Connect Shopify

The Shopify preset can add Storefront, Admin, or both. After you save, Koda mints a fresh Storefront token and tests the connection so shoppers are not sent to Shopify’s password page.

1. 1

   In Connected Services, select Shopify under Explore presets.

   

2. 2

   Enter your Shopify store domain (for example example-store.myshopify.com).

3. 3

   Choose Add Storefront service for catalog, cart, and checkout through Storefront GraphQL. Choose Add Admin service for merchant operations such as products, orders, and inventory. Add both if the app needs both.

4. 4

   Open each new Shopify service and enter the Shopify app’s client ID and client secret. Keep the secret marked as Secret value.

   

5. 5

   Select Save setup. Koda remints the Storefront token on save and runs Proxy verification. Look for Connection test passed before asking the agent to use Shopify.