New features, fixes, and supported Flutter versions in Shorebird. Expand an entry for the full detail, the command, and the doc it belongs to. Subscribe with the RSS feed.
shorebird channels delete now refuses stable, beta, and staging with a usage error before contacting the server, which already refuses them.
--json, the success object no longer includes is_default_track, since a successful delete can no longer involve a built-in track.CLI 1.6.128 also fixes these issues.
--release-version read the release version from the flavor's build.SHOREBIRD_PATCH_DD_MAX_BYTES.shorebird release, shorebird patch, and shorebird preview no longer leave copies of the app in the system temp directory.shorebird doctor --fix shows every issue a fix leaves, and the count of fixable issues is accurate. --fix with --json is now a usage error.android:name isn't its first attribute, and reports a permission removed with tools:node="remove" instead of offering a fix that conflicts with it.shorebird patch aar without --release-version in a non-interactive shell fails before building instead of crashing after it.shorebird patch ios-framework without --release-version now lets you pick the release in an interactive terminal, like other platforms.shorebird preview launches an app on a device running iOS 16 or earlier, Ctrl-C works normally for the rest of the run.shorebird patches set-track and shorebird init now use the same flag names as the commands next to them. The old names still work, but no longer appear in --help.
shorebird patches set-track takes --release-version and --patch-number, like the other patches commands, in place of --release and --patch.shorebird init takes --org-id, like shorebird apps transfer, in place of --organization-id.shorebird init, shorebird channels create, and shorebird patches set-track, as shorebird apps rename already did. shorebird patch now also rejects a --track that is empty, only whitespace, or longer than 128 characters.shorebird init --org-id 42With --json, every failing command now prints an error object on stdout, and a failed check before the command runs reports precondition_failed with a message and, when there's a known fix, a hint.
precondition_failed include not being logged in and not being in a Shorebird project.shorebird patches set-track now reports changed and the patch, as rollback and rollforward already did, so a script can tell whether the run did anything.macOS patches now install on apps that were re-signed after release, such as for Developer ID notarization or the Mac App Store.
--flutter-version, keep the old behavior.shorebird patch now embeds the public key from --public-key-cmd in the patch build, as shorebird release already did.
--public-key-path reached the patch build. Signing itself still worked.--public-key-cmd command now runs once per shorebird patch or shorebird release run, instead of once per architecture or platform, so a command that prompts, such as for two-factor authentication, prompts once.shorebird preview now takes --flavor, like other commands that act on an app, so it can pick the flavor's app without asking.
shorebird releases get-apks now takes --app-id, and with it no longer needs to run in a Shorebird project. Pass --out in that case.shorebird preview --flavor internal --release-version 1.0.0+1shorebird release now clears build/<platform>/shorebird/ before building on every platform, so files left by an earlier build aren't uploaded with a new release.
build/ is touched.shorebird patches set-track now succeeds when the patch is already on the requested track, instead of failing with a usage error.
shorebird patches rollback and rollforward, so a retried CI job doesn't fail.--json, changed is false when nothing changed.Commands that act on an existing app now fail when --flavor names a flavor that shorebird.yaml doesn't define, instead of silently using the default app.
shorebird patches rollback --flavor previously rolled back a patch on the default app.patches, releases, channels, and apps commands. The error lists the flavors that shorebird.yaml defines.--app-id still takes precedence over --flavor.Four commands that could crash now work or fail with a clear message.
shorebird login no longer crashes with Bad state: read(ScopedRef<Browser>), a bug introduced in 1.6.126.shorebird doctor --verbose shows Gradle as not detected when the Gradle version lookup fails, instead of crashing.shorebird patches set-track and shorebird patches promote report a patch number that isn't a number as a usage error instead of crashing.shorebird patch linux now builds with --target and the arguments passed after --, so the patch matches the release it targets.
--, such as --dart-define values, so it could differ from its release.shorebird release linux does.API keys now hold exactly what their permission level grants. A full access key can do everything your role allows, except delete your account, change your billing limits, or manage your sessions and API keys. Sign in to the Console to do these.
personal_access_token_forbidden. Keys were already refused both, with other error codes.The app list no longer shows an app twice when you have both a role in its organization and a role granted on the app itself.
GET /api/v1/apps, shorebird account apps, shorebird apps list, and the app picker in shorebird preview.Flutter installs, engine artifacts, and downloaded previews that you no longer use are now removed automatically, so they stop piling up across upgrades and --flutter-version builds.
shorebird cache clean --unused removes unused items right away, without clearing the rest of the cache.shorebird cache clean --unusedShorebird now supports Flutter 3.47.7 and Dart 3.13.5.
OverlayPortal, which were shrunk and anchored top-left, so VoiceOver focus and XCUITest taps missed the visible controls.ReorderableListView.shorebird release ios --flutter-version=3.47.7With Xcode 26 or later, shorebird preview on an iOS device now shows the app's print output and [shorebird] updater lines, as Android and macOS previews do.
shorebird login now opens your browser, and when no browser can open, such as over SSH, in CI, or on Linux without a display, it shows a code to enter in a browser on any device.
--device to use a code even when a browser is available.shorebird login without --device crashes with Bad state: read(ScopedRef<Browser>). Upgrade to 1.6.127 or later.shorebird login --devicePatching an Android release built with --obfuscate on a Flutter version older than 3.41.2 no longer fails with Unrecognized flags: load_obfuscation_map.
gen_snapshot failure.shorebird release ios and shorebird release ios-framework now check the Flutter version they actually build with, including --flutter-version.Errors from shorebird init, shorebird patch, shorebird preview, and the checks that run before a command now name the step that fixes them.
shorebird patch --force explains that there's no --force flag and points to --allow-native-diffs and --allow-asset-diffs.--json, the --force advice is in the error's hint.shorebird release ios now warns when an app extension's version or build number differs from the app's, which App Store Connect rejects with ITMS-90473.
NotificationService.appex: CFBundleShortVersionString is "1.15.32", the app is "1.15.67".shorebird login now uses standard OAuth with PKCE and state, and shorebird logout now warns when the auth server can't confirm that your session was revoked.
shorebird login:ci, are no longer supported. The server stopped accepting them on October 1, 2026. Run shorebird login to sign in again, and use an API key in SHOREBIRD_TOKEN for CI.shorebird login signs you in again instead of reporting that you're already logged in.shorebird release and shorebird patch now support --json, so a script gets the new release or patch as data instead of parsing log lines.
shorebird release --json reports the app ID, the platforms, and each release with its version, Flutter version, and per-platform status.shorebird patch --json reports the app ID, the track, and each patch with its platform, release version, patch number, and link percentage.--dry-run, both report what would have been published, with dry_run set to true.--json, stdout holds only the JSON object. Progress and logs go to stderr.shorebird patch android --release-version=latest --jsonSign-ins no longer end at a fixed 90 days. A sign-in now lasts until it goes 30 days without use, so you stay signed in as long as you keep using Shorebird.
API responses now carry RateLimit and RateLimit-Policy headers, so scripts can see their limit and how close they are to it.
Retry-After header and the code rate_limited.Shorebird now supports Flutter 3.47.6 and Dart 3.13.5.
shorebird release windows --flutter-version=3.47.6When shorebird patch android finds DEX changes, it now lists the Android libraries whose versions differ from the release, which usually explains a native change you didn't make.
io.branch.sdk.android:library 5.21.2 -> 5.21.3, along with added and removed libraries.--allow-native-diffs is safe for that patch.--allow-native-diffs and --allow-asset-diffs hints are now printed before the command fails.Since October 1, 2026, tokens from shorebird login:ci and logins from CLI versions older than 1.6.87 are rejected.
legacy_auth_retired.SHOREBIRD_TOKEN.shorebird upgrade, then shorebird logout and shorebird login.The sidebar now lists the active organization's apps, and the organization's app list can now be filtered, sorted, and paged.
The invite dialog now has a role picker, so a new member joins with any role your plan offers instead of always as a Developer.
Change Track is now offered on a patch that a newer patch has superseded on its track, so an older staging patch can still be promoted to stable.
Each pending invitation in an organization's members list now has a button that shows its link, so you can send it yourself.
Shorebird now supports Flutter 3.47.5 and Dart 3.13.4.
shorebird release ios --flutter-version=3.47.5--flutter-version now accepts fvm and system, so you no longer have to look up and repeat your Flutter version number.
--flutter-version=fvm uses the version fvm resolves for your project from its .fvmrc. It requires fvm on your PATH.--flutter-version=system uses the version reported by the flutter on your PATH.shorebird release android --flutter-version=fvmOn iOS, --split-debug-info now writes a Mach-O dSYM, so symbol servers ingest it and Dart stack traces from production become readable.
--flutter-version still gets the old file.The organizations list is split into Owned by you and Member of, and each organization shows its plan tier.
The automatic patch check now starts after the patch the device boots has loaded, instead of before, so it reports the patch the device is actually running. With auto_update: false, your app's own updater call decides when to check.
Shorebird now supports Flutter 3.47.4 and Dart 3.13.3.
shorebird release ios --flutter-version=3.47.4shorebird release android and shorebird patch android now stop with an explanation when the built app bundle has no libapp.so, your compiled Dart code, for any architecture.
shorebird release android pointed at ABI filters.libapp.so is written.CLI 1.6.121 also fixes these issues.
flutter.jar, the error names the plugin to upgrade.shorebird init no longer separates a comment in your pubspec's flutter: section from the key it describes when it adds the assets: entry.shorebird release and shorebird patch now name the flag to fix. For example, a key file that doesn't exist names the flag it was passed to, and shorebird patch with only one of --public-key-path and --private-key-path names the one that's missing..xcarchive or a release built with Flutter older than 3.22.2, now say what to do next.--flutter-version, now resumes on the next run instead of needing shorebird cache clean.Shorebird now supports Flutter 3.47.3 and Dart 3.13.3.
shorebird release android --flutter-version=3.47.3New shorebird apps commands list, rename, delete, and transfer apps without opening the Console.
shorebird apps transfer --org-id <id> moves an app into another organization. Run shorebird account orgs to find the id.shorebird apps rename --name <name> changes the display name.shorebird apps delete has no prompt. Pass --confirm-name with the app's current display name to confirm.shorebird apps transfer --app-id <id> --org-id 42New shorebird channels commands create, list, and delete the channels (tracks) an app can publish to.
--track=<name> still creates that channel automatically.shorebird channels delete has no prompt. Pass --confirm-name with the channel name to confirm. Devices on a deleted channel stop receiving patches.stable, beta, and staging channels can't be deleted.shorebird channels create --app-id <id> --name qashorebird account whoami now shows your plan level and whether you have an active subscription.
free, pro, business, or enterprise.--json, the level is in a new plan_level field. The existing plan field still reads paid or free, so scripts that use it keep working.shorebird account whoamiThe new Plan page under Account replaces the Plan tab in each organization's settings, since a plan belongs to your account and covers every organization you own.
The Size tab is now available on every plan, including Free, and releases are analyzed whatever plan they're on. Pricing will come later.
Deleting the stable, beta, or staging channel is now refused, since it would unpublish every patch on that track.
channels_delete_default_channel.On iOS and macOS, shorebird patch no longer reports an asset change for a layered app icon (.icon) that you didn't change.
Shorebird now supports Flutter 3.47.2 and Dart 3.13.2.
--build-name and --build-number are now forwarded to version.json.shorebird release android --flutter-version=3.47.2shorebird patches rollback and shorebird patches rollforward do the same as the Rollback and Roll Forward actions in the Console.
--release-version and --patch-number.--require-change to exit with an error instead.shorebird patches rollback --release-version 1.0.0+1 --patch-number 1Nothing matches that search. Clear the field or pick a different area.