Textguard 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.

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.

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 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
    or APKs per CPU type: flutter build apk --release --split-per-abi. Result: 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, both bundle ids and your App Group in Xcode (Rename). The TextguardFilter extension is embedded in the app and uploads with it.
  2. Build:
    cd app
    flutter build ipa --release --dart-define=API_BASE_URL=https://your-server.example
    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.

The author's checks were flutter build ios --no-codesign (it works; Runner.app/PlugIns/TextguardFilter.appex is embedded) and flutter build apk --release (debug-signed). Signed store builds are yours to run.

04Listing wording

Describe the app as an offline, rule-based text checker that explains what it found. Keep to what it does: do not call it AI, do not promise that it blocks every scam or that a text is safe, and say plainly that on Android it checks text the user shares, selects or pastes and does not filter incoming SMS, and that the iOS filter only handles texts from unknown senders. Google Play also asks you to declare in the Data safety form that no message text is collected. In the App Store review notes, explain how to switch the filter on (Settings, Messages, Unknown & Spam) so the reviewer can test it.