---
title: Find the guide for a task
description: Find the guide for each Turn Zero Cloud task, the most common first, and the page for each skill the platform offers.
slug: /getting-started/find-a-guide
order: 10
visibility: public
redirects_from: [/getting-started/find-the-guide-for-a-task]
---

# Find the guide for a task

Choose a task below to open its guide. If something fails, start with the matching troubleshooting page: [Setup](/cloud/troubleshooting/setup/), [Deploys](/cloud/troubleshooting/deploys/), [Secrets](/cloud/troubleshooting/secrets/), and [Status and logs](/cloud/troubleshooting/status-and-logs/).

Each guide explains the procedure and how to check its result. Your AI tool should read the guide before making changes.

The [Quick reference](/cloud/getting-started/quick-reference/) lists the calls each common task takes, and where each key limit is stated.

## Tasks and their guides

### The most common tasks

| Task | Guide |
| --- | --- |
| Connect your AI coding tool and sign in | [Connect your AI assistant](/cloud/getting-started/connect-your-tool/) |
| Build a new app or bring existing code, test in development, and publish | [Build, test and publish an app](/cloud/getting-started/build-test-and-publish-an-app/) |
| Deploy an application to production | [Deploy from your computer](/cloud/getting-started/deploy-an-application/) |
| Build a service that keeps its data in a database | [Build a database-backed service](/cloud/getting-started/build-a-database-backed-service/) |
| Let your app's users sign in | [Add sign-in to your app](/cloud/guides/add-sign-in-to-your-app/) |
| Publish a site of HTML, CSS and images as a serverless application | [Publish a static site](/cloud/guides/publish-a-static-site/) |
| Serve a web client beside the backend, with its fonts, images, and third-party libraries among its files | [Serve a web client](/cloud/guides/serve-a-web-client/) |
| Build and deploy an app from a chat | [Deploy from a chat](/cloud/getting-started/build-an-app-from-a-chat/) |
| Choose what to do from a chat without a terminal | [Build from a chat AI (no terminal)](/cloud/getting-started/build-from-a-chat-ai/) |
| Read the scaffold templates and their complete source files | [Example applications](/cloud/examples/overview/) |
| Store an API key or another secret | [Store a secret](/cloud/getting-started/store-a-secret/) |
| Call an AI model with no provider key of your own | [Call an AI model under the allowance](/cloud/guides/call-an-ai-model-under-the-allowance/) |
| Build a public AI summarizer that keeps notes and summaries in a database | [Build a public AI summarizer with saved history](/cloud/guides/build-a-public-ai-summarizer-with-saved-history/) |
| Run AI calls on your own Anthropic, OpenAI, Google, or xAI key | [Use your own AI keys](/cloud/guides/use-your-own-ai-keys/) |
| Build a mobile app's backend | [Build a mobile app's backend](/cloud/getting-started/build-a-mobile-app-backend/) |

Two explanation pages answer the questions most deploys raise: [A deployed app's settings](/cloud/concepts/the-settings-a-deployed-copy-receives/) and [The deploy health check](/cloud/concepts/the-deploy-health-check/).

### Set up, deploy, and run

| Task | Guide |
| --- | --- |
| Check what your computer needs | [What your computer needs](/cloud/getting-started/prerequisites/) |
| Bring an application built elsewhere | [Bring an existing application](/cloud/guides/bring-an-existing-application/) |
| Build, test, and deploy with nobody at the keyboard to sign in | [Deploy with nobody at the keyboard](/cloud/guides/deploy-with-nobody-at-the-keyboard/) |
| Start a new service from a template | [Starting a new service](/cloud/concepts/turnzero-command/#starting-a-new-service), in The turnzero command |
| Look up the options of a turnzero command line, or the status it ended with | [turnzero command reference](/cloud/reference/turnzero-command/) |
| Look up what a turnzero command line reads or prints | [turnzero command input and output](/cloud/concepts/what-the-turnzero-command-reads-and-prints/) |
| Write or change the manifest (the JSON file that describes your application: its services, health path, and other settings), and fix what a refusal reports | [Author the manifest](/cloud/guides/author-the-manifest/) |
| Run the application on your machine | [Run your app on your computer](/cloud/guides/run-your-application-on-your-machine/) first, for the environment file and settings (environment variables). Then [Test your application locally](/cloud/guides/test-your-application-locally/) for the tests. |
| Write a local run's development credentials into the environment file | [Running on your machine](/cloud/concepts/turnzero-command/#running-on-your-machine), in The turnzero command |
| Test each version in development, then promote it to production | [Test in development, then promote](/cloud/guides/turn-on-development-and-promote/) |
| Roll back, halt, rename, or delete an environment or an application | [Manage versions and environments](/cloud/guides/manage-versions-and-environments/) |
| Keep a WebSocket connection open for live updates | [Use WebSockets](/cloud/guides/use-websockets/) |
| Put the application on a domain of your own | [Attach your own domain](/cloud/guides/attach-your-own-domain/) |
| Run work on a schedule | [Add a scheduled job](/cloud/guides/add-a-scheduled-job/) first, for the steps. Then [Run scheduled work](/cloud/guides/author-the-manifest/#run-scheduled-work), in Author the manifest, for the declaration and the runs. Then the [Schedule](/cloud/backend-packages/schedule/) package page, for what the handler must do. |

### Data, files, and outside services

| Task | Guide |
| --- | --- |
| Add a database to an application you already have | [Add a database](/cloud/guides/add-a-database/) |
| Build a public form with saved database entries and routes to read, change and delete them | [Build a form backed by a database](/cloud/guides/build-a-form-backed-by-a-database/) |
| Store each user's files, and let a browser or a native app upload or download one with a transfer grant (a short-lived permission for one named file) | [Store files](/cloud/guides/store-files/) |
| Give the backend a secret's value without pasting it into chat | [Keep a secret value out of chat](/cloud/guides/supply-a-secret-value-without-exposing-it/) |
| Call an external API with a key you stored | [Call an external API with an API key](/cloud/guides/call-an-external-api-with-an-api-key/) |
| Generate a picture with no provider key of your own | [Generate an image with AI](/cloud/guides/generate-an-image-under-the-allowance/) |
| Have your AI tool draw one picture now and save it, with no code | [Generate an image with your AI assistant](/cloud/guides/generate-an-image-from-your-ai-tool/) |
| Receive a provider's signed webhook | [Receive a signed webhook](/cloud/guides/receive-a-signed-webhook/) |
| Save signed webhook deliveries once in a database, check development, and promote | [Build a webhook receiver with a database](/cloud/guides/build-a-webhook-receiver-with-a-database/) |
| Email a person from an application's backend | [Send email from your application](/cloud/guides/send-email-from-your-application/) |
| Read logs and counters, and erase old records | [Read logs and counters](/cloud/guides/read-logs-and-counters/) |

### Sign-in and users

| Task | Guide |
| --- | --- |
| Let your app's users send feedback, and read their reports with your AI tool | [Let your app's users send feedback](/cloud/guides/let-your-apps-users-send-feedback/) |
| Tell which user sent a request | [Tell which user sent a request](/cloud/guides/add-sign-in-to-your-app/#3-tell-which-user-sent-a-request), in Add sign-in to your app |
| Keep an admin route, such as deleting a message, for yourself alone | [Let only you reach an admin route](/cloud/guides/add-sign-in-to-your-app/#6-let-only-you-reach-an-admin-route), in Add sign-in to your app |
| Choose who may sign up, or show a private beta's notice page | [Make sign-up invitation-only](/cloud/guides/make-sign-up-invitation-only/) |
| Add work-account or Apple sign-in | [Add work-account or Apple sign-in](/cloud/guides/add-work-account-or-apple-sign-in/) |
| Invite, list, suspend, or delete end users (the people who sign in to your app), and change the settings of their realm (the list of users for one environment of your app) | [Manage end users](/cloud/guides/manage-end-users/) |
| Test sign-in with no person signing in | [Test sign-in with test end users](/cloud/guides/test-sign-in-with-test-end-users/) |
| Build an app whose signed-in users keep private notes in a database | [Build a notes app with sign-in and a database](/cloud/guides/build-a-notes-app-with-sign-in-and-a-database/) |
| Build an app whose signed-in users have an AI conversation | [Build an app with sign-in and AI](/cloud/guides/build-an-app-with-sign-in-and-ai/) |

### Mobile and desktop apps

| Task | Guide |
| --- | --- |
| Sign in the users of a mobile or desktop app | [Sign in from a native app](/cloud/guides/sign-in-from-a-native-app/) |
| Turn away old versions of a mobile app | [Keep installed clients compatible](/cloud/guides/keep-installed-clients-compatible/) |
| Send push notifications | [Send push notifications](/cloud/guides/send-push-notifications/) |

### Account, size, tokens, and the library

| Task | Guide |
| --- | --- |
| Mint a token for a script, a pipeline, or a contractor's tool | [Mint a token](/cloud/guides/mint-a-token/) |
| Call a management action from a script or shell with no MCP tools | [Mint a token](/cloud/guides/mint-a-token/#3-use-it) |
| Sign a script that has no MCP client in to one of Turn Zero's own products | [Sign in from a script](/cloud/guides/sign-in-from-a-script/) |
| Change the size, or read usage | [Size and usage](/cloud/guides/plan-and-usage/) |
| Compare where each size runs production, how it starts after idle, and its CPU and memory | [How the sizes differ technically](/cloud/concepts/how-the-plans-differ-technically/) |
| See which account your AI tool acts for | [Your account](/cloud/guides/your-account/) |
| Link a second sign-in, or register a passkey | [Identities and passkeys](/cloud/guides/identities-and-passkeys/) |
| Export your account, or delete it | [Export or delete your account](/cloud/guides/export-or-delete-your-account/) |
| Hand an app's code and exported data to another account | [Hand an app to another account](/cloud/guides/hand-an-app-to-another-account/) |
| Add or update a reusable feature package from the library | [Use the library](/cloud/guides/use-the-library/) |
| Report a problem with the platform | [Feedback](/cloud/guides/feedback/) |
| Keep an issue list for a repository or a test program | [Keep your own issue list](/cloud/guides/keep-your-own-issue-list/) |

### Testing and networks

| Task | Guide |
| --- | --- |
| Run the tests offline on the packages' test doubles, which stand in for the packages so the tests need no account or connection | [Test your application locally](/cloud/guides/test-your-application-locally/) |
| Find out why the app loads on one network and not another | [When a network blocks Turn Zero](/cloud/guides/diagnose-a-blocked-network/) |

## Files or a database for a list of records

You can keep a list of records as a JSON file in a storage area or as rows in the database:

- A file suits a small list the application reads and writes whole, such as its settings or a scheduled handler's state. The application should write each change with a conditional put, which saves only if the file is unchanged since it was read. This ensures one writer never overwrites another's change.
- The database suits a list that grows, that the application searches, sorts, or pages through, or that several requests change at once. A guestbook or link shortener fits when its list grows and several requests can write at once. [Build a form backed by a database](/cloud/guides/build-a-form-backed-by-a-database/) gives a worked example.
- Files also suit content sent unchanged, such as images, uploads, and exports.

[Store files](/cloud/guides/store-files/) covers the conditional put, and [Add a database](/cloud/guides/add-a-database/) covers the database.

## The skills

A skill is a set of steps offered as a Model Context Protocol (MCP) prompt. Some AI tools show it as a slash command. If your AI tool shows no prompts, it reads a platform skill with `read_context`, id `skill:<name>`. Each platform skill links to a guide with examples.

For another product your connection offers, first read its `skills:<product>` entry to find its skills. Then read one with `read_context`, id `skill:<prefixed-name>`. That read sends no arguments; a client that shows prompts can run one with arguments itself. [How an AI reads these docs](/cloud/concepts/reading-this-documentation-as-a-tool/#what-the-action-reads) explains the entries and refusals.

The library provides reusable feature packages for capabilities such as sign-in, storage, and AI calls, with integration instructions and, where provided, code to include in your app.

| Skill | Purpose and guide |
| --- | --- |
| `skill:deploy` | [Deploy from your computer](/cloud/getting-started/deploy-an-application/) |
| `skill:store-key` | [Store a secret](/cloud/getting-started/store-a-secret/) |
| `skill:add-service` | [Add a database](/cloud/guides/add-a-database/) |
| `skill:add-sign-in` | [Add sign-in to your app](/cloud/guides/add-sign-in-to-your-app/) |
| `skill:manifest-author` | [Author the manifest](/cloud/guides/author-the-manifest/) |
| `skill:use-ai-allowance` | [Call an AI model under the allowance](/cloud/guides/call-an-ai-model-under-the-allowance/) |
| `skill:mobile-backend` | [Build a mobile app's backend](/cloud/getting-started/build-a-mobile-app-backend/) |
| `skill:schedule` | [Add a scheduled job](/cloud/guides/add-a-scheduled-job/) |
| `skill:move-existing-app` | [Bring an existing application](/cloud/guides/bring-an-existing-application/) |
| `skill:develop-then-promote` | Set up a development environment, deploy changes there, then promote them to production. [Guide](/cloud/guides/turn-on-development-and-promote/) |
| `skill:release` | Promote a version already in development, check production, and roll back if you request it. With no development environment, check the version deployed directly to production. [Guide](/cloud/guides/turn-on-development-and-promote/) |
| `skill:diagnose` | [Read logs and counters](/cloud/guides/read-logs-and-counters/) |
| `skill:cost-estimate` | [Stay inside the Free Allowance](/cloud/guides/stay-inside-the-monthly-free-usage/) |
| `skill:cost-review` | [Size and usage](/cloud/guides/plan-and-usage/) |
| `skill:custom-domain` | [Attach your own domain](/cloud/guides/attach-your-own-domain/) |
| `skill:add-library-entry` | Choose a feature package from the library and add it to your project. [Guide](/cloud/guides/use-the-library/) |
| `skill:update-library` | Check for newer versions of the packages in your project, ask which to update, and apply their migration steps. [Guide](/cloud/guides/use-the-library/) |
| `skill:delete-account` | [Export or delete your account](/cloud/guides/export-or-delete-your-account/) |

A nineteenth, `platform-admin`, is offered only to platform staff. [MCP resources and prompts](/cloud/reference/discovery/) lists the actions used by the customer skills in the table above.

A short skill is one page. A long skill has a first page with its steps and rules, and a page of the reasons behind the rules: `skill:add-service`, `skill:deploy`, `skill:mobile-backend`, `skill:release`, and `skill:schedule` are long. The `skill:deploy` skill also has a page for each case, such as an application with a database. The `skill:add-service` skill has one for running the application on your own machine. The `skill:release` skill has `skill:release:verify` for checking a release.

Some skill rules include a separate line explaining when they apply. Each first page lists the skill's other pages by id.
