Upload Builds
Upload Android APK and iOS IPA builds with real-time progress and instant shareable download links.
The buildshare upload command uploads an Android APK or iOS IPA package to BuildShare, displaying real-time upload progress and printing a public OTA install URL upon completion.
Usage
buildshare upload <file> [flags]Examples
Upload an Android APK file directly:
buildshare upload ./app-release.apkFlags & Options
| Flag | Short | Description |
|---|---|---|
--app <id> | — | Target a specific app by its ID or slug |
--notes <text> | — | Release notes or change description for this build |
--ci | — | Run in non-interactive CI mode (suppresses prompts, spinners, and colors) |
--json | — | Output result as structured JSON instead of human-readable text |
--verbose | -v | Enable detailed debug logging for request/response traces |
Real-Time Progress & Shareable Output
When running in an interactive terminal, the CLI renders an animated progress indicator with elapsed transfer speed and estimated completion time:
Uploading app-release.apk [========================>---] 82% (42.5 MB / 51.8 MB) 4.2 MB/sUpon a successful upload, the CLI prints the generated OTA installation link:
✔ Upload completed successfully!
Install Link: https://buildshare.in/install/bld_982348a7b
Build ID: bld_982348a7b
App ID: com.example.myapp
Version: 1.4.0 (42)
Size: 51.8 MBStructured JSON Mode
When passing --json, output is formatted as JSON, making it easy to parse from bash, Python, or CI/CD step outputs:
{
"status": "success",
"build": {
"id": "bld_982348a7b",
"app_id": "com.example.myapp",
"app_name": "My App",
"platform": "android",
"version_name": "1.4.0",
"version_code": "42",
"install_url": "https://buildshare.in/install/bld_982348a7b",
"file_size": 54316234,
"created_at": "2026-03-20T14:32:00Z"
}
}