Brierly docs
v1.0.0
Get help
● Ship

Release builds
signing and uploading.

The commands that build a release, and how to sign it with your own keys. The build commands come from app/README.md; signed store builds were not made while writing this guide (unverified).

APKApp BundleIPA

01Version number

In app/pubspec.yaml the line version: 1.0.0+1 is name + build number. Raise the build number for every upload. The server's version is in server/package.json and PRODUCT_VERSION in server/src/admin/manifest.ts.

02Android

Windows users

Flutter runs natively on Windows: use PowerShell for the flutter commands and Android builds (iOS builds need a Mac). For the server, either install Node.js 22.12+ for Windows and use PowerShell (replace cp .env.example .env with Copy-Item .env.example .env; there is no openssl by default, so use WSL or any random 64-character hex string), or run the commands in WSL 2 (Ubuntu) or Docker. macOS and Linux users can ignore this note.

  1. Create an upload key (keep it and its passwords safe, forever):
    keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
  2. Create app/android/key.properties with storePassword, keyPassword, keyAlias, storeFile, and edit app/android/app/build.gradle.kts so the release build type uses a signingConfig built from it. As shipped, release builds are signed with the debug key (signingConfig = signingConfigs.getByName("debug")) and Play will refuse them.
  3. Build an App Bundle for Play:
    cd app
    flutter build appbundle --release \
      --dart-define=API_BASE_URL=https://your-server.example.com
    or an APK:
    flutter build apk --release --dart-define=API_BASE_URL=https://your-server.example.com
    The result is in build/app/outputs/.
  4. Upload the .aab in Play Console, fill in the data safety form, and release to a test track first.

Do not commit key.properties or the keystore.

03iOS

  1. Set your team and bundle id in Xcode (Rename).
  2. Build:
    cd app
    flutter build ios --release --dart-define=API_BASE_URL=https://your-server.example.com
    or flutter build ipa --release --dart-define=..., or open ios/Runner.xcworkspace, choose Any iOS Device, Product, Archive.
  3. Upload the archive with Xcode Organizer (Distribute App, App Store Connect) or Transporter.
  4. In App Store Connect add the in-app purchases to the version, screenshots, and the privacy details.

Release builds were not run for this guide: unverified. The Podfile platform is 16.0.

04Listing wording

Describe the app as a forecasting-skill and calibration trainer: the user enters their own probability before seeing the crowd's, then learns from a Brier score and a calibration curve. Keep to what the app does. Do not call it a betting, trading or advice app, do not promise results, and credit the data source as described in Attribution. Use your own screenshots of your build.