---
title: Native Builds FAQ
description: Frequently asked questions about Capawesome Cloud Native Builds — supported frameworks, signing, build minutes, concurrency, overages, and configuration.
faq: true
---

# FAQ

## General

### Which frameworks are supported?

Native Builds works with Capacitor, Cordova, and native iOS and Android projects.

### Do I need a Mac to build for iOS?

No. iOS builds run on managed macOS build machines in the cloud, so you can build and sign iOS apps without a Mac. See [How builds work](builds.md).

### Where do I configure my project (monorepo, package manager)?

In a `capawesome.config.json` file — see [Configuration file](configuration.md), [Build from a monorepo](monorepo.md), and [Use pnpm, Yarn, or bun](package-managers.md).

## Signing

### Do I need a signing certificate?

Debug (Android) and Simulator (iOS) builds don't require signing. Any build you install on a real device or submit to a store must be signed. See [Certificates](certificates/index.md).

## Builds

### How are builds billed?

By build minutes — the time a build spends running. Only active build time counts; time spent queued while waiting for a machine doesn't. See [Limits & quotas](limits.md) and [Estimate usage](estimate-usage.md).

### What happens when I reach my monthly build-minute limit?

Any builds already running are allowed to finish — we never cancel a build mid-way. We'll notify you by email so you can upgrade your plan for more headroom. There are no metered overage charges.

### Are additional build minutes available?

Build minutes are included with your plan. To get more, upgrade to a higher plan — we don't sell separate build-minute packs. See the [pricing page](https://capawesome.io/pricing/){:target="_blank"}.

### Is the concurrent build limit a hard limit? What happens when all slots are busy?

The number of builds that can run at the same time depends on your plan, but it's not a hard failure. When every slot is busy, additional builds are queued and start automatically as capacity frees up. Queue time doesn't count toward your build minutes.

### Can I see build usage per app?

Usage is tracked at the organization level. Per-app usage reporting is currently in private beta — [reach out to us](../../support/index.md) if you'd like access.

### Why did my build fail?

The fastest way to find out is [Ask AI](../assist/ask-ai.md) on the failed build. See also [Troubleshooting](troubleshooting.md).

### How do I get the mapping.txt file for Google Play deobfuscation?

You don't need to. When you enable R8/ProGuard and publish your app as an Android App Bundle (AAB), the mapping file is embedded in the bundle and Google Play applies it automatically to deobfuscate crash and ANR reports. See [Publish Android App Bundles](android-app-bundles.md).

### Can I build without connecting a Git repository?

Yes — build from local files with the CLI. See [Build without Git](build-without-git.md).

### Can I share a build with testers who don't have an account?

Yes. Share a succeeded build via a public link and testers can view and install it without a Capawesome Cloud account. Build logs are never exposed, and you can revoke the link at any time. See [Share a build](share-a-build.md).