Compare Bundles

Quick Start

You'll typically receive two bundle identifiers. Follow these steps:

1. Run tuist bundle list --json to find bundles on each branch.
2. Run tuist bundle show <bundle-id> --json for both base and head bundles.
3. Compare artifact trees with tuist bundle artifact list <bundle-id> --json.
4. Compare install size, download size, and other metadata.
5. Summarize size changes with actionable recommendations.

Step 1: Resolve Bundles

If base/head are bundle IDs or dashboard URLs

Fetch each directly:

tuist bundle show <base-id> --json
tuist bundle show <head-id> --json

If base/head are branch names

List recent bundles on each branch and pick the latest:

tuist bundle list --git-branch <base-branch> --json
tuist bundle list --git-branch <head-branch> --json

Then fetch full details with tuist bundle show <id> --json.

Defaults

• If no base is provided, use the project's default branch (usually main).
• If no head is provided, detect the current git branch.

Step 2: Compare Artifact Trees

After fetching both bundles with tuist bundle show <id> --json, compare the individual artifacts:

tuist bundle artifact list <base-id> --json
tuist bundle artifact list <head-id> --json

Match artifacts by name across both bundles. Look for:

• New artifacts added in the head bundle (potential size contributors)
• Removed artifacts (explain size decreases)
• Size changes in existing artifacts

Step 3: Compare Top-Level Metrics

After fetching both bundles, compare:

Metric	What to check
install_size	Flag if head is >5% larger
download_size	Flag if head is >5% larger
version	Note version changes
supported_platforms	Note platform changes
app_bundle_id	Should match between base and head