flutter_runner_cli 1.0.8

CLI interaktif untuk menjalankan Flutter app — pilih environment (Local/Dev/Prod), pilih device, lalu auto-run dengan dart-define yang sesuai. Cocok untuk developer yang sering gonta-ganti environment [...]

Flutter Runner CLI

CLI interaktif untuk menjalankan Flutter app — pilih environment (Local/Dev/Prod), pilih device, lalu auto-run dengan --dart-define yang sesuai.

Zero external dependencies — hanya pakai dart:io dan dart:convert.

Fitur

• 🎯 Pilih Environment — Local (auto-detect IP), Dev, atau Production
• 📱 Pilih Device — Deteksi otomatis device dari flutter devices
• ⚡ Auto Run — flutter run dengan --dart-define yang sesuai
• 🔧 Config Wizard — --init buat bikin .flutter_runner.json
• 🏢 Multi-project — Bisa dipake di project Flutter mana aja
• 📦 Zero dependencies — Ringan, gak perlu install library tambahan

Install

# Aktifkan global
dart pub global activate flutter_runner_cli

# Jalankan dari mana aja
flutter-runner

Atau tanpa install:

dart run flutter_runner_cli

Usage

flutter-runner            # Menu interaktif (pilih env → pilih device → run)
flutter-runner --init     # Buat/configurasi .flutter_runner.json
flutter-runner --help     # Bantuan

Alur Interaktif

Step 1 — Pilih Environment:

╔══════════════════════════════════════════╗
║          Pilih Environment               ║
╚══════════════════════════════════════════╝

  1)  🏠  Local
      IP otomatis :8000

  2)  🔧  Dev
      https://staging.example.com

  3)  🌐  Production
      https://api.example.com

Step 2 — Pilih Device:

╔══════════════════════════════════════════╗
║          Pilih Device                    ║
╚══════════════════════════════════════════╝

  1) iPhone 17 Pro (65F7E385-...)
  2) Pixel 7 (emulator-5554)

Step 3 — Auto Run:

$ flutter run -d <device> --dart-define=BASE_URL=<url> ...

Config

Bikin file .flutter_runner.json di root project:

flutter-runner --init

Atau buat manual:

{
  "local_port": "8000",
  "dev_url": "https://staging.example.com",
  "prod_url": "https://api.example.com",
  "extra_defines": {
    "APP_NAME": "MyApp",
    "API_KEY": "abc123"
  }
}

Field Config

Field	Wajib	Deskripsi
local_port	✅	Port backend lokal (contoh: 8000)
dev_url	❌	URL backend development
prod_url	❌	URL backend production
extra_defines	❌	--dart-define tambahan (key-value)

Tanpa config file: flutter-runner akan error dan nyuruh bikin config pake --init.

Environment Variables

Override config via environment variable:

FLUTTER_RUNNER_LOCAL_PORT=9000 flutter-runner
FLUTTER_RUNNER_DEV_URL=https://staging.example.com flutter-runner

Development

git clone https://github.com/adibagasp23/flutter_runner_cli
cd flutter_runner_cli
dart run

Testing

dart analyze   # Static analysis
dart format .  # Code formatting
dart run       # Manual testing

Publikasi

dart pub publish

Lisensi

MIT — lihat LICENSE.