mhmzdev/appflight-cli-docsLight logoAppFlight CLI

AppFlight CLI

Upload Android APKs to AppFlight directly from your terminal or CI pipeline — no phone required.

AppFlight CLI lets you upload Android APKs to AppFlight directly from your laptop or CI pipeline — no phone required.

appflight upload --flavor stage

Why CLI?

The AppFlight mobile app is great for managing testers and browsing builds, but real development happens on laptops and build servers. The CLI closes that loop:

  • Build on your machine → upload in one command
  • Wire into GitHub Actions or Codemagic
  • No Firebase credentials or service account keys needed — just an API key

How it works

  1. Generate an API key — AppFlight mobile app → Settings → API Keys → tap +
  2. Install the CLI — dart pub global activate appflight_cli
  3. Init your project — appflight init --flavors stage:com.myapp.stage,prod:com.myapp
  4. Login — appflight login and paste your key
  5. Build and upload — flutter build apk --flavor stage --release && appflight upload --flavor stage

Commands

CommandDescription
initCreate appflight.json in your project root
loginSave your API key to ~/.appflight/credentials.json
uploadBuild and upload an APK to AppFlight
whoamiPrint the currently authenticated user
logoutRemove saved credentials from this machine

Requirements

  • Dart SDK >=3.0.0
  • An AppFlight account with at least one app created
  • An API key from the AppFlight mobile app
Edit this page on GitHub
📱 Get the App