Skip to content

VoiceStudio is the open-source, fully-local ElevenLabs alternative — voice cloning, voice design, video dubbing, dictation, transcription & audiobook creation in 646 languages.

ci(mobile): draft a GitHub prerelease with the APK, AAB and IPAs on mobile tags

debpalash271968f097e1
diff --git a/.github/workflows/mobile-release.yml b/.github/workflows/mobile-release.yml
index ff187fe7f..46d35ac13 100644
--- a/.github/workflows/mobile-release.yml
+++ b/.github/workflows/mobile-release.yml
@@ -3,6 +3,9 @@
# each store console. The app version is the root package.json version; each
# run's number is the store build number (VS_BUILD_NUMBER). Secrets live in the
# protected `mobile-release` environment; see docs/mobile.md → Releasing.
+# A `mobile-v*` tag also collects every binary into a DRAFT GitHub prerelease
+# (signed APK + AAB, signed IPA, unsigned IPA for sideloading) for the owner to
+# review and publish, like the desktop release.
name: mobile-release
@@ -196,6 +199,25 @@ jobs:
path: ${{ runner.temp }}/ipa/*.ipa
retention-days: 30
+ # Unsigned device build for people who sideload with their own Apple ID
+ # (the store IPA above is signed for App Store Connect and will not install
+ # outside TestFlight).
+ - name: Unsigned iPhone build for sideloading
+ run: |
+ xcodebuild -project mobile/ios/VoiceStudio/VoiceStudio.xcodeproj \
+ -scheme VoiceStudio -configuration Release -sdk iphoneos \
+ -destination 'generic/platform=iOS' -derivedDataPath "$RUNNER_TEMP/device" \
+ CODE_SIGNING_ALLOWED=NO CODE_SIGNING_REQUIRED=NO CODE_SIGN_IDENTITY="" build
+ mkdir -p "$RUNNER_TEMP/unsigned/Payload"
+ cp -R "$RUNNER_TEMP/device/Build/Products/Release-iphoneos/VoiceStudio.app" "$RUNNER_TEMP/unsigned/Payload/"
+ (cd "$RUNNER_TEMP/unsigned" && zip -qry "$RUNNER_TEMP/VoiceStudio-unsigned.ipa" Payload)
+
+ - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+ with:
+ name: VoiceStudio-ios-unsigned
+ path: ${{ runner.temp }}/VoiceStudio-unsigned.ipa
+ retention-days: 30
+
- name: Upload to TestFlight
if: github.event_name == 'push' || inputs.upload
env:
@@ -214,3 +236,49 @@ jobs:
security delete-keychain "$RUNNER_TEMP/release.keychain-db" || true
rm -f "$RUNNER_TEMP/cert.p12" "$HOME/.appstoreconnect/private_keys/"*.p8
rm -rf "$HOME/Library/MobileDevice/Provisioning Profiles"
+
+ # Tag builds gather every binary into a draft prerelease; nothing is public until
+ # the owner publishes it. Skipped for manual runs, which only produce artifacts.
+ release:
+ if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/mobile-v')
+ needs: [android, ios]
+ runs-on: ubuntu-24.04
+ timeout-minutes: 15
+ permissions:
+ contents: write
+ steps:
+ - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+ with:
+ path: assets
+
+ - name: Draft prerelease
+ env:
+ GH_TOKEN: ${{ github.token }}
+ TAG: ${{ github.ref_name }}
+ REPO: ${{ github.repository }}
+ run: |
+ set -eu
+ mkdir -p out
+ cp assets/VoiceStudio-android-release/VoiceStudio.apk "out/VoiceStudio-${TAG}.apk"
+ cp assets/VoiceStudio-android-release/VoiceStudio.aab "out/VoiceStudio-${TAG}.aab"
+ cp assets/VoiceStudio-ios-release/*.ipa "out/VoiceStudio-${TAG}-appstore.ipa"
+ cp assets/VoiceStudio-ios-unsigned/VoiceStudio-unsigned.ipa "out/VoiceStudio-${TAG}-unsigned.ipa"
+ (cd out && sha256sum * > SHA256SUMS.txt)
+ cat > notes.md <<NOTES
+ VoiceStudio phone apps ${TAG}. Preview builds; they run models on the phone.
+
+ | File | Use |
+ |---|---|
+ | \`VoiceStudio-${TAG}.apk\` | Android: install directly (allow installs from this source) |
+ | \`VoiceStudio-${TAG}.aab\` | Android App Bundle for Google Play |
+ | \`VoiceStudio-${TAG}-unsigned.ipa\` | iPhone: sideload with your own Apple ID (for example Sideloadly) |
+ | \`VoiceStudio-${TAG}-appstore.ipa\` | App Store Connect build; it only installs through TestFlight |
+
+ Verify downloads against \`SHA256SUMS.txt\`. Details: docs/mobile.md.
+ NOTES
+ if gh release view "$TAG" --repo "$REPO" >/dev/null 2>&1; then
+ test "$(gh release view "$TAG" --repo "$REPO" --json isDraft --jq .isDraft)" = true || { echo "Refusing to replace a published release"; exit 1; }
+ gh release upload "$TAG" out/* --repo "$REPO" --clobber
+ else
+ gh release create "$TAG" out/* --repo "$REPO" --verify-tag --draft --prerelease --title "$TAG — VoiceStudio mobile" --notes-file notes.md
+ fi
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 99be37bd0..928008999 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -73,6 +73,7 @@ metadata and the backend fallback mirror it.
### CI
+- New `mobile-release` workflow builds signed Android and iOS apps and drafts a GitHub prerelease with the APK, AAB and IPAs, with optional Play internal and TestFlight uploads (#2969)
- Desktop request-guard self-tests stay deterministic when app requests arrive during cleanup (#2676)
- New `mobile` workflow builds and tests both phone apps; a contract test fails when their theme or API description drifts from the desktop app (#2965)
diff --git a/docs/RELEASING.md b/docs/RELEASING.md
index 49c39b48e..8284d0e82 100644
--- a/docs/RELEASING.md
+++ b/docs/RELEASING.md
@@ -160,6 +160,14 @@ the opt-in **Beta** channel (below). Previews between betas are builds from
`main` (the `electron-build.yml` artifacts or Docker `:latest`), never a side
branch. No Tauri build is maintained.
+## Mobile apps
+
+Phone apps ship on their own `mobile-v*` tags through the `mobile-release`
+workflow (Play internal track, TestFlight and a draft GitHub prerelease with the
+APK, AAB and IPAs). The version is the root `package.json` version and each run's
+number is the store build number. Setup, secrets and sideloading: `docs/mobile.md`
+→ Releasing. Publishing the draft and promoting the store builds are manual.
+
## Beta channel
Beta is a second release channel cut from `main`, for testers who opt in under
diff --git a/docs/mobile.md b/docs/mobile.md
index 75b431407..e3a478d8f 100644
--- a/docs/mobile.md
+++ b/docs/mobile.md
@@ -101,6 +101,11 @@ never publishes to production; promote a build in each store console.
- **Run it:** Actions → `mobile-release` → Run workflow (uploads are off by
default, so you get signed artifacts to test), or push a `mobile-v*` tag
(builds and uploads both).
+- **Downloads for everyone:** a `mobile-v*` tag also creates a **draft** GitHub
+ prerelease with the signed APK and AAB, the App Store IPA, an unsigned IPA for
+ sideloading, and `SHA256SUMS.txt`. Review it, then publish. The App Store IPA
+ only installs through TestFlight; iPhone users outside TestFlight sideload the
+ unsigned IPA with their own Apple ID.
- **Version:** the root `package.json` version. Each run's number is the store
build number, so a rebuild of the same version still uploads.
- **Secrets** (repository environment `mobile-release`, with required reviewers):