Deprecations
This page lists everything Shorebird has retired or plans to retire: Flutter versions, Shorebird CLI versions, credentials and commands. Each entry names what replaces it.
Apps already in the app stores are never affected. They keep downloading and installing patches whatever the deprecation.
Stages
Section titled “Stages”Each deprecation moves through four stages:
- Announced: listed on this page, with a date once one is set.
- Warning: the CLI and console tell affected teams what to change and by when.
- Enforced: the old version or credential is refused, with an error naming the fix.
- Removed: Shorebird no longer carries any support for it.
Upcoming
Section titled “Upcoming”| Deprecation | Stage | Date | Move to |
|---|---|---|---|
| Shorebird CLI older than 1.6.0 | Announced | Not set | Run shorebird upgrade |
| Logins made with a CLI before 1.6.125 | Announced | Not set | Run shorebird upgrade, then shorebird logout and shorebird login |
Shorebird CLI older than 1.6.0
Section titled “Shorebird CLI older than 1.6.0”Publishing releases and patches will need Shorebird 1.6.0 or newer. In CI, update the Shorebird version your pipeline installs, or use Setup Shorebird, which installs the latest.
Logins made with a CLI before 1.6.125
Section titled “Logins made with a CLI before 1.6.125”A shorebird login made with a CLI before 1.6.125 will stop working. Upgrade,
then log out and log in again. CI that uses an API key in
SHOREBIRD_TOKEN is not affected.
Current
Section titled “Current”| Deprecation | Stage | Date | Move to |
|---|---|---|---|
| Flutter older than 3.24.0 (Android, iOS) | Enforced | October 23, 2026 | A supported Flutter version |
| Legacy login tokens | Enforced | October 1, 2026 | A service account or API key in CI; a new shorebird login elsewhere |
| Shorebird CLI older than 1.4.0 | Enforced | Run shorebird upgrade | |
--confirm-name on channels delete and releases delete | Warning | --yes, in Shorebird 1.6.129 or newer | |
| Shorebird CI, the hosted GitHub App | Removed | August 25, 2026 | The shorebird_ci package |
Flutter versions
Section titled “Flutter versions”Shorebird supports Flutter versions at most two years old. Shorebird 1.6.131 and newer refuse new Android and iOS releases on Flutter older than 3.24.0; patches to releases already built on one keep working. The supported minimum for each platform is in Supported Flutter versions, and known issues with specific versions are in Flutter version notes.
Legacy login tokens
Section titled “Legacy login tokens”Tokens from shorebird login:ci, and logins made with a CLI before 1.6.87,
stopped working on October 1, 2026. On your own machine, run
shorebird upgrade, then shorebird logout and shorebird login. In CI,
create a service account or
API key in the console and set it as SHOREBIRD_TOKEN.
See
Getting Shorebird credentials onto the builder.
Shorebird CI
Section titled “Shorebird CI”The hosted Shorebird CI GitHub App stopped running checks on August 8, 2026, and
was removed on August 25, 2026. The
shorebird_ci package generates a
GitHub Actions workflow that runs the same checks in your repository. See
Shorebird CI to move to it and remove the App.