fpack 1.1.17

Package Flutter apps into release artifacts for every platform (apk, aab, ipa, dmg, exe, msix, deb, rpm, AppImage, web) with one command. Native Go core, thin Dart launcher.

fpack

English · 中文

📖 Documentation → matkurban.github.io/fpack

Guides for every platform (signing, notarization, installers), every command and config key, CI recipes and troubleshooting. A complete sample app with a commented fpack.yaml lives in example/.

One command turns a Flutter project into release artifacts for every platform. It works with zero configuration, reads pubspec.yaml, Gradle and the Xcode projects, and never modifies your project files.

Install

Requires Dart 3.8+ (bundled with Flutter).

dart pub global activate fpack

Make sure ~/.pub-cache/bin (Windows: %LOCALAPPDATA%\Pub\Cache\bin) is on your PATH, then check:

fpack --version

The first run downloads the matching native core (≈4 MB, SHA-256 verified). Offline and mirror options: Installation.

Quick start

cd my_flutter_app
fpack init                       # (optional) commented fpack.yaml; --yes uses the detected defaults
fpack doctor                     # what can this machine build? what is missing and how to install it?
fpack build apk --dry-run        # shows the commands that would run (runs nothing)
fpack build apk                  # first build → dist/1.0.0+1/my_app-1.0.0+1-android-universal.apk
fpack build --all                # everything this machine can build; the rest is skipped with a reason

Artifacts go to dist/<version>+<build>/ together with SHA256SUMS. Existing artifacts are never overwritten: bump the version, use --build-number N, or pass --force.

A minimal fpack.yaml

Every key is optional. This is enough to build and sign an Android release:

app:
  display_name: My App
build:
  targets: [apk, aab]                # built by `fpack build` without targets
android:
  signing:
    store_file: ~/keys/upload.jks
    store_password: ${FPACK_ANDROID_KEYSTORE_PASSWORD}   # never write passwords into the file
    key_alias: upload

Supported targets

Android: apk · aab — iOS: ipa — macOS: macos · dmg · pkg — Windows: windows · exe · msix — Linux: linux · deb · rpm · appimage · snap — Web: web.

fpack list shows every target and whether this machine can build it. Details and artifact names: Targets.

More docs

Everything else lives on the documentation site: matkurban.github.io/fpack

• Getting started · Installation · Commands · Targets
• Configuration reference · Environment variables
• Platform guides (signing, notarization, installers): Android · iOS · macOS · Windows · Linux · Web
• CI examples · Troubleshooting · FAQ
• AI agent skill · Architecture · Changelog
• Source and issues: GitHub · pub.dev

License

MIT