StageX

stagex_dart builds Flutter apps with pinned SDKs and StageX container images, then compares the output against a committed per-file manifest.

Verified: Linux and web on Linux/amd64; macOS .app on the pinned macOS/arm64 host. Other targets and hosts are experimental and verify rejects them. release-check supports Linux and web. Windows hosts should run inside a WSL2 distribution.

Install

dart pub global activate stagex
stagex_dart --help

Or from source:

git clone https://github.com/ManyMath/stagex.git
cd stagex
dart pub get --enforce-lockfile
dart run packages/stagex/bin/stagex_dart.dart --help

Reproduce the example

Needs Docker 25+, Dart, curl, tar, and sha256sum (macOS: Xcode, curl, unzip, shasum).

apps/flutter-example/tool/reproduce.sh linux
apps/flutter-example/tool/reproduce.sh web
apps/flutter-example/tool/reproduce.sh macos   # on the pinned macOS host

Configure an app

stagex_dart init linux
stagex_dart pin
# set flutter.checksums in stagex.yaml
stagex_dart setup linux
stagex_dart doctor
stagex_dart build linux
stagex_dart verify linux --no-build --update   # establish the reference
stagex_dart verify linux --no-build            # check against it

Commit expected-hashes/ and stagex.lock. eject writes standalone build scripts; verification still needs the CLI.