Upload APKs and IPAs to BuildShare to instantly get shareable OTA install links.

Upload Builds

Uploading your binary builds (APK/AAB for Android or IPA for iOS) directly to BuildShare is incredibly fast. The CLI is fully optimized for large files (up to 2GB) using chunked, resumable uploads.

Before uploading, ensure you have initialized your project with buildshare init or you provide the --file path manually.

The Upload Command

The core upload command is split by platform to ensure correct parsing of the mobile manifest files (like AndroidManifest.xml and Info.plist).

buildshare upload android [options]

buildshare upload ios [options]

Interactive Flow

When running the upload command interactively (without providing specific options like --no-confirm), the CLI provides a guided, safe experience:

Build Detection

The CLI automatically detects eligible build files in your directory (e.g., app/build/outputs/apk/release/*.apk). If multiple are found, it provides an interactive selection menu.

Changelog Entry

It prompts you to enter a brief changelog or release note description for this specific upload.

Version Overrides

It automatically parses the version from your build, but asks if you'd like to override the version name (e.g., 1.0.0) and version code (e.g., 1).

Verification

Displays a detailed terminal table summarizing the file name, size, type, git branch, and commit hash for verification, prompting you to confirm before the upload starts.

Non-Interactive / CI Mode

For CI/CD environments (GitHub Actions, Bitrise), you want to bypass the interactive prompts entirely.

Always use the --no-confirm flag when running the CLI in a CI/CD pipeline to prevent the process from hanging while waiting for user input.

# Example: Non-interactive Android upload with full metadata
buildshare upload android \
  --file ./app-release.apk \
  --changelog "Fixed notification crash on Android 13" \
  --version-name "1.2.0" \
  --version-code "12" \
  --no-confirm

Available Options

Flag	Description
`-f, --file <path>`	Path to your build file. If omitted, uses the path from `.buildshare/project.json`.
`-c, --changelog <msg>`	Build release notes/changelog.
`--branch <branch>`	Associated git branch (defaults to current local git branch).
`--commit <hash>`	Associated git commit hash.
`--version-name <name>`	Custom build version name (e.g. `2.1.0`). Overrides parsed manifest.
`--version-code <code>`	Custom build version code (e.g. `42`). Overrides parsed manifest.
`--no-confirm`	Skip the summary check and upload confirmation prompt.
`--qr`	Automatically render the OTA installation QR code directly in the terminal upon success.

Uploading Builds