fluttercraft CLI (fluttercraft) - Craft Your Flutter Builds with Precision #

A cross-platform Dart CLI tool for building Flutter apps. Replaces PowerShell build scripts with a single portable executable.

✨ Key Features #

• Interactive Shell - Continuous REPL for rapid development
• Streamlined Build Process - Build, version, and deploy in one flow
• Seamless Integrations - FVM, Shorebird, auto-determine versions and context
• Custom Command Aliases - Define reusable command sequences via flc run <alias>
• Edit Before Build - Modify build command before execution (v0.1.0)
• Reload Config - Hot-reload configuration in shell mode (v0.1.0)

Quick Start #

# Generate config (optional but recommended)
fluttercraft gen

# Build interactively
fluttercraft build

# Or build directly
fluttercraft build --type apk --no-confirm

📦 Installation #

From pub.flutter-io.cn (Recommended) #

# Install globally
dart pub global activate fluttercraft

# Use anywhere
flc --version
flc build

From Binary #

1. Download fluttercraft.exe from releases
2. Add to PATH or run directly:

   .\fluttercraft.exe --help
   

From Source #

# Clone and activate
git clone https://github.com/venhdev/fluttercraft-cli.git
cd fluttercraft-cli
dart pub global activate --source path .

# Or install directly from git
dart pub global activate --source git https://github.com/venhdev/fluttercraft-cli.git

Run Directly (No Installation) #

# Clone repository
git clone https://github.com/venhdev/fluttercraft-cli.git
cd fluttercraft-cli

# Run commands
fvm dart run bin/fluttercraft.dart --help
fvm dart run bin/fluttercraft.dart build

Commands #

| build | Build Flutter app (APK/AAB/IPA) | flc build --type apk | | clean | Clean project and dist folder | flc clean --dist-only | | convert | Convert AAB to universal APK | flc convert --aab app.aab | | gen | Generate fluttercraft.yaml | flc gen --force | | run | Run custom command alias | flc run gen-icon |

Shell Commands (in interactive mode):

Interactive Mode:

flc --shell            # Start interactive shell
flc -s                 # Start interactive shell (short)

Direct Mode:

flc                    # Show help (default)
flc build --type apk --no-confirm
flc run --list

Configuration #

First Run (No Config Required) #

The CLI works without fluttercraft.yaml:

• Reads app name/version from pubspec.yaml
• Uses sensible defaults
• Run fluttercraft gen to create config file

fluttercraft.yaml #

app:
  name: testapp

build:
  name: 1.0.1
  number: 10
  type: apk
  flavor: null
  target: lib/main.dart

paths:
  output: dist
  env: ./.env

flags:
  use_dart_define: false
  need_clean: false
  need_build_runner: false

fvm:
  enabled: true
  version: null  # Auto-detected from .fvmrc if null

shorebird:
  enabled: false
  app_id: null   # Auto-detected from shorebird.yaml
  artifact: null
  no_confirm: true  # Skip confirmation prompts

alias:
  gen-icon:
    cmds:
      - fvm flutter pub get
      - fvm flutter pub run flutter_launcher_icons
  brn:
    cmds:
      - fvm flutter pub get
      - fvm flutter packages pub run build_runner build --delete-conflicting-outputs

Custom Command Aliases #

Define reusable command sequences in fluttercraft.yaml:

alias:
  gen-icon:
    cmds:
      - fvm flutter pub get
      - fvm flutter pub run flutter_launcher_icons
  brn:
    cmds:
      - fvm flutter pub get
      - fvm flutter packages pub run build_runner build --delete-conflicting-outputs

Then run them with:

flc run gen-icon
flc run brn
flc run --list  # Show all available aliases

FVM Integration #

Auto-Detection: When fvm.enabled: true and version: null, the CLI reads .fvmrc:

{
  "flutter": "3.35.3"
}

Manual Pin: Override with explicit version:

fvm:
  enabled: true
  version: 3.24.0

Disable FVM:

fvm:
  enabled: false

Output #

Build artifacts: dist/{app_name}_{version}+{build_number}.{ext}

Example: myapp_1.2.3+45.aab

Logs:

• .fluttercraft/build_latest.log
• .fluttercraft/logs/{build-id}.log
• .fluttercraft/build_history.jsonl

Development #

fvm dart pub get                       # Install dependencies
fvm dart test                          # Run tests
fvm dart analyze                       # Analyze code
.\scripts\compile.ps1                  # Compile to binary

License #

MIT