flutter_helper_tools 1.0.0

A Flutter build automation CLI tool — build APK, AAB, and IPA with multi-flavor support, and upload artifacts via rclone to any cloud storage (Google Drive, S3, Dropbox, etc.).

flutter_helper_tools

Flutter build automation CLI — build APK, AAB, and IPA with multi-flavor support, then upload artifacts via rclone to Google Drive, S3, Dropbox, or any of the 70+ remotes rclone supports.

Unlike gdrive, rclone gives you explicit, non-silent errors on every failure, full progress output, and works with virtually any cloud storage.

---

Features

• Clean Flutter, Android, and iOS projects
• Build Android APK, App Bundle (AAB), and iOS IPA
• Multi-flavor support (auto-detected from build.gradle)
• Upload artifacts via rclone (Google Drive, S3, Dropbox, OneDrive, …)
• Auto-copies shareable download link to clipboard
• Desktop notifications (macOS + Linux)
• Saves upload destinations so you never retype a remote path
• Interactive menu and non-interactive CLI flags — use whichever fits your workflow
• FVM (Flutter Version Manager) support

---

Prerequisites

1 · rclone

Download rclone for your operating system. Your can find the instructions in here :

https://rclone.org/install/

Then configure your remote once:

rclone config

Follow the prompts to add a remote (e.g. gdrive for Google Drive).
After that, a path like gdrive:MyApp/Android works everywhere in this tool.

2 · Flutter / FVM

Make sure flutter (or fvm) is on your PATH.

---

Installation

Global CLI (recommended)

dart pub global activate flutter_helper_tools

Then run from any Flutter project directory:

fh

As a dev dependency (team scripts, CI)

# pubspec.yaml
dev_dependencies:
  flutter_helper_tools: ^1.0.0

dart run flutter_helper_tools

---

Usage

Interactive menu

Just run fh with no arguments from a Flutter project root:

═══════════════════════════════════════
     FLUTTER BUILD AUTOMATION MENU
═══════════════════════════════════════
1.  🧹 Clean Flutter (clean + pub get)
2.  🧹 Clean Android project only
3.  🧹 Clean iOS project only
4.  📦 Build Android APK
5.  📦 Build Android APK + Upload via rclone
6.  📦 Build Android App Bundle
7.  🍎 Build iOS IPA
8.  📦 Build multiple Android APKs (multi-flavor)
9.  📦 Build multiple Android APKs + Upload (multi-flavor)
10. 📦 Build multiple App Bundles (multi-flavor)
11. 📦 Build multiple App Bundles + Upload (multi-flavor)
12. 🍎 Build multiple iOS IPAs (multi-flavor)
13. 🧹 Clean ALL (Flutter + Android + iOS)
14. 🚀 Build ALL (Android + iOS)
15. 🍎 Build iOS IPA + Upload via rclone
16. 🍎 Build multiple iOS IPAs + Upload (multi-flavor)
17. 🚀 Build APK + IPA + Upload via rclone
18. 🚀 Build ALL (Android + iOS) — Multiple Flavors
19. 👋 Quit
═══════════════════════════════════════

Non-interactive (CI / scripts)

# Build APK for a specific flavor
fh build apk --flavor staging

# Build and upload in one step
fh build apk --flavor staging --upload

# Build IPA
fh build ipa --flavor production --upload

# Build App Bundle
fh build aab --flavor staging

# Upload an already-built artifact
fh upload --file build/app/outputs/flutter-apk/app-staging-release.apk \
          --remote gdrive:MyApp/Android \
          --name "MyApp" \
          --flavor staging

# Clean all
fh clean --all

# Manage saved destinations
fh project list
fh project add --name "MyApp Android" --remote "gdrive:MyApp/Android"
fh project remove

---

Upload destinations

The tool saves your rclone remote paths so you only type them once:

fh project add
# → App display name: MyApp
# → rclone remote path: gdrive:MyApp/Android

Saved in ~/.flutter_helper_projects.json.

---

Artifact filename format

Uploaded files are named automatically:

MyApp staging v1.4.2 (19-04-2026).apk
MyApp production v1.4.2 (19-04-2026).ipa
MyApp sprint3 staging v1.4.2 (19-04-2026).aab
 ^app  ^custom  ^flavor ^version  ^date

---

Why rclone instead of gdrive?

	gdrive (glotlabs)	rclone
Error reporting	Silent on many failures	Always explicit, exit code + stderr
Upload progress	None	Live progress bar
Cloud support	Google Drive only	70+ remotes
Shareable links	Requires extra step	rclone link built-in
Maintenance	Stalled	Actively maintained

---

License

MIT