> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revyl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Build your iOS and Android apps on Revyl's cloud build runners

`revyl build` runs your app build on Revyl's cloud infrastructure by default.
Use it for Expo, React Native, native iOS, and native Android projects when you
want Revyl to produce the app binary for you.

Builds run on large runners with 12 CPUs and 24 GB RAM. You give Revyl the same
commands you would run locally or in CI, and Revyl stores the finished build on
your app so you can launch devices and run tests against it.

## What you can use them for

* **Cloud builds for agents.** A local agent or cloud agent can change code, run a build, and get a real app artifact back without needing your machine.
* **Fast CI.** Trigger iOS or Android builds from lightweight CI jobs instead of maintaining mobile runners yourself.
* **PR previews.** Build and test pull requests automatically, with Revyl posting status back to GitHub.
* **One place for builds and tests.** The finished build is already in Revyl, so the next step is launching a device or running a test.

## FAQ

### What do I configure?

Your `.revyl/config.yaml` defines customer-named profiles. Each profile owns an
iOS and/or Android recipe with its Revyl app, ordered commands, and output
artifact. `revyl build --profile <name> --platform ios|android`
selects one recipe; no profile is stored as active or default.

### What does Revyl build?

For iOS, produce a simulator `.app` or an archive that contains one. For
Android, produce an installable `.apk`.

## Requirements

* [Revyl CLI](/cli/index) installed and authenticated
* A same-platform Revyl app configured as the recipe's `app_id` (`revyl app create` or the [Apps page](/builds/index))
* A runnable recipe in `.revyl/config.yaml` inside a Git worktree (see the [quickstart](/remote-builds/quickstart))
* Available cloud-build capacity for your organization

<Note>
  Remote builds consume metered compute credits and are subject to billing and
  capacity checks. If your plan or available credits do not permit the build,
  submission returns a billing error. Check your plan or contact
  [support@revyl.ai](mailto:support@revyl.ai).
</Note>

## Docs

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/remote-builds/quickstart">
    Install the CLI, run init, and start your first build.
  </Card>

  <Card title="Configuration" icon="sliders" href="/remote-builds/configuration">
    The `build:` section of `.revyl/config.yaml` and every CLI flag.
  </Card>

  <Card title="Toolchain Images" icon="layer-group" href="/remote-builds/toolchains">
    Available images and installed tools.
  </Card>

  <Card title="Caching" icon="database" href="/remote-builds/caching">
    Use automatic compilation caches and configured path caches.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.