---
title: "Build & Release Pipeline"
description: "Remote build farm, release approvals, rollout percentages, and multi-target deployments."
category: "Cloud Platform"
url: "https://bloom-platform-ten.vercel.app/docs/cloud/build-and-release"
last_updated: "2026-08-16"
---

# Build & Release Pipeline

> Compile in the cloud, gate releases behind approval, and deploy to every distribution target from one pipeline. Open the dashboard at [cloud.bloom.dev](https://cloud.bloom.dev).

## Remote Build Farm

Every build runs on Bloom's managed workers—no local iOS/Android toolchain required.

```bash
# Trigger a cloud build for a platform + environment
bloom cloud build --platform ios --environment production
bloom cloud build --platform android --environment staging

# Watch logs live
bloom cloud logs --build <build-id> --follow
```

Build stages: **Queued** &rarr; **Staging** (source checkout, dependency resolution) &rarr; **Compiling** (platform-specific AOT compilation with pinned SDK versions) &rarr; **Artifact Upload** (signed `.ipa`/`.aab`/web bundle). Each build has its own deep-linkable detail page with a live stage timeline, streaming logs, and artifact downloads.

## Releases & Approvals

A release wraps a completed build with a changelog and a rollout percentage. Releases in `pending_approval` can't ship until a Release Manager or above approves them:

```bash
# Create a release from a completed build
bloom cloud release create --build <build-id> --changelog "Fix checkout tax calculation"

# Approve (Release Manager+ only)
bloom cloud release approve --release <release-id>
```

Every release can be rolled back to any prior version in one click, and two releases can be diffed side-by-side before approving.

## Deployments

A deployment ships a specific release to a specific target, with platform-aware status tracking:

- **TestFlight**: Internal/external tester distribution via App Store Connect.
- **App Store**: Public release, subject to Apple review.
- **Google Play (Internal/Closed)**: Staged Android tracks before production rollout.
- **Web / Preview**: Instant preview URLs and production Flutter Web hosting.

## Environments

Environments (Production, Staging, Preview, Dev by default) each pin their own Flutter/Dart/Bloom SDK versions, build flavor, environment variables, and feature flags. An environment can't be deleted while it still has builds attached.

## Related Documentation
- [Cloud Platform Overview](https://bloom-platform-ten.vercel.app/docs/cloud/overview.md)
- [Secrets, Signing & Git](https://bloom-platform-ten.vercel.app/docs/cloud/secrets-and-signing.md)
- [Open Cloud Dashboard](https://cloud.bloom.dev)