---
title: "Deprecations"
description: "Every current and upcoming Shorebird deprecation, with its stage, date and what to move to."
---

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

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

| 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

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](/code-push/ci/github/), which installs the latest.

### 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](/account/api-keys/) in `SHOREBIRD_TOKEN` is not affected.

## Current

| Deprecation                                                 | Stage    | Date             | Move to                                                                                             |
| ----------------------------------------------------------- | -------- | ---------------- | --------------------------------------------------------------------------------------------------- |
| Flutter older than 3.24.0 (Android, iOS)                    | Enforced | October 23, 2026 | A [supported Flutter version](#flutter-versions)                                                    |
| [Legacy login tokens](#legacy-login-tokens)                 | Enforced | October 1, 2026  | A [service account](/account/service-accounts/) 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`](#shorebird-ci) package                                                         |

### 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](/getting-started/flutter-version/#supported-flutter-versions), and known issues with specific versions are in [Flutter version notes](/getting-started/flutter-version/#flutter-version-notes).

### 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](/account/service-accounts/) or [API key](/account/api-keys/) in the console and set it as `SHOREBIRD_TOKEN`. See [Getting Shorebird credentials onto the builder](/code-push/ci/generic/#getting-shorebird-credentials-onto-the-builder).

### 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`](https://pub.dev/packages/shorebird_ci) package generates a GitHub Actions workflow that runs the same checks in your repository. See [Shorebird CI](/ci/) to move to it and remove the App.