Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

feat(studio): Fly.io deprecation banner (#45778)

Pamela Chiae55411da5ed6
diff --git a/apps/studio/components/interfaces/App/AppBannerWrapper.tsx b/apps/studio/components/interfaces/App/AppBannerWrapper.tsx
index b59ad529fab..22a4cb613c1 100644
--- a/apps/studio/components/interfaces/App/AppBannerWrapper.tsx
+++ b/apps/studio/components/interfaces/App/AppBannerWrapper.tsx
@@ -3,6 +3,7 @@ import { PropsWithChildren } from 'react'
import { OrganizationResourceBanner } from '../Organization/HeaderBanner'
import { ClockSkewBanner } from '@/components/layouts/AppLayout/ClockSkewBanner'
+import { FlyDeprecationBanner } from '@/components/layouts/AppLayout/FlyDeprecationBanner'
import { NoticeBanner, NoticeBanner2 } from '@/components/layouts/AppLayout/NoticeBanner'
import { StatusPageBanner } from '@/components/layouts/AppLayout/StatusPageBanner'
@@ -17,6 +18,7 @@ export const AppBannerWrapper = ({ children }: PropsWithChildren<{}>) => {
<StatusPageBanner />
{showNoticeBanner && <NoticeBanner />}
{showNoticeBanner2 && <NoticeBanner2 />}
+ <FlyDeprecationBanner />
<OrganizationResourceBanner />
{/* Disabled until reintroduced or removed altogether. */}
{/* <TaxIdBanner /> */}
diff --git a/apps/studio/components/layouts/AppLayout/FlyDeprecationBanner.tsx b/apps/studio/components/layouts/AppLayout/FlyDeprecationBanner.tsx
new file mode 100644
index 00000000000..b4517d5447c
--- /dev/null
+++ b/apps/studio/components/layouts/AppLayout/FlyDeprecationBanner.tsx
@@ -0,0 +1,222 @@
+import { LOCAL_STORAGE_KEYS } from 'common'
+import { useRouter } from 'next/router'
+import { useEffect, useRef, type ReactNode } from 'react'
+import {
+ Button,
+ cn,
+ Dialog,
+ DialogClose,
+ DialogContent,
+ DialogDescription,
+ DialogFooter,
+ DialogHeader,
+ DialogSection,
+ DialogSectionSeparator,
+ DialogTitle,
+ DialogTrigger,
+} from 'ui'
+
+import { HeaderBanner } from '@/components/interfaces/Organization/HeaderBanner'
+import { InlineLink, InlineLinkClassName } from '@/components/ui/InlineLink'
+import {
+ useFlyDeprecationProjects,
+ type FlyDeprecationProject,
+} from '@/hooks/misc/useFlyDeprecationProjects'
+import { useLocalStorageQuery } from '@/hooks/misc/useLocalStorage'
+import { useTrack } from '@/lib/telemetry/track'
+
+const BANNER_EXPIRES_AT = new Date('2026-06-01T00:00:00Z')
+const BACKUP_RESTORE_CLI_URL =
+ 'https://supabase.com/docs/guides/platform/migrating-within-supabase/backup-restore'
+const DASHBOARD_RESTORE_URL =
+ 'https://supabase.com/docs/guides/platform/migrating-within-supabase/dashboard-restore'
+const BRANCHING_DASHBOARD_URL = 'https://supabase.com/docs/guides/deployment/branching/dashboard'
+const SUPPORT_EMAIL = '[email protected]'
+
+export const FlyDeprecationBanner = () => {
+ const router = useRouter()
+
+ const [acknowledged, setAcknowledged, { isSuccess }] = useLocalStorageQuery(
+ LOCAL_STORAGE_KEYS.FLY_DEPRECATION_2026_05_31,
+ false
+ )
+
+ const isExpired = Date.now() >= BANNER_EXPIRES_AT.getTime()
+ const onSignIn = router.pathname.startsWith('/sign-in')
+
+ const shouldEvaluate = !isExpired && !onSignIn && isSuccess && !acknowledged
+
+ const { isReady, primaries, branches } = useFlyDeprecationProjects({ enabled: shouldEvaluate })
+
+ const hasFlyResources = primaries.length > 0 || branches.length > 0
+
+ const track = useTrack()
+
+ const exposedRef = useRef(false)
+ useEffect(() => {
+ if (!shouldEvaluate || !isReady || !hasFlyResources || exposedRef.current) return
+ exposedRef.current = true
+ track('fly_deprecation_banner_exposed', {
+ primaryCount: primaries.length,
+ branchCount: branches.length,
+ })
+ }, [shouldEvaluate, isReady, hasFlyResources, primaries.length, branches.length, track])
+
+ if (!shouldEvaluate || !isReady || !hasFlyResources) return null
+
+ const onDismiss = () => {
+ track('fly_deprecation_banner_dismissed', {
+ primaryCount: primaries.length,
+ branchCount: branches.length,
+ })
+ setAcknowledged(true)
+ }
+
+ const title =
+ primaries.length > 0 && branches.length > 0
+ ? 'Action required: Fly.io project and branch suspensions begin May 31'
+ : primaries.length > 0
+ ? 'Action required: Fly.io project suspensions begin May 31'
+ : 'Action required: Fly.io branch suspensions begin May 31'
+
+ return (
+ <HeaderBanner
+ variant="warning"
+ title={title}
+ description={<FlyDeprecationDialog primaries={primaries} branches={branches} />}
+ onDismiss={onDismiss}
+ />
+ )
+}
+
+const FlyDeprecationDialog = ({
+ primaries,
+ branches,
+}: {
+ primaries: FlyDeprecationProject[]
+ branches: FlyDeprecationProject[]
+}) => {
+ return (
+ <Dialog>
+ <DialogTrigger className={cn(InlineLinkClassName, 'cursor-pointer')}>
+ View affected projects
+ </DialogTrigger>
+ <DialogContent>
+ <DialogHeader>
+ <DialogTitle>Fly.io deprecation: suspensions begin May 31, 2026</DialogTitle>
+ <DialogDescription>
+ Supabase will begin suspending projects and branches still running on Fly.io
+ infrastructure on May 31, 2026.
+ </DialogDescription>
+ </DialogHeader>
+
+ <DialogSectionSeparator />
+
+ <ProjectList
+ label="Projects on Fly.io"
+ items={primaries}
+ instructions={
+ <>
+ <p>
+ To preserve your data, migrate each project to Supabase's general infrastructure:
+ </p>
+ <ol className="list-decimal pl-5 space-y-1">
+ <li>
+ Back up your database using the{' '}
+ <InlineLink href={BACKUP_RESTORE_CLI_URL}>Supabase CLI</InlineLink> (or take a{' '}
+ <InlineLink href={DASHBOARD_RESTORE_URL}>Dashboard backup</InlineLink>).
+ </li>
+ <li>Create a new project on Supabase's general infrastructure.</li>
+ <li>Restore the backup into the new project.</li>
+ </ol>
+ </>
+ }
+ />
+
+ <ProjectList
+ label="Branches on Fly.io"
+ items={branches}
+ instructions={
+ <>
+ <p>Merge preview branches before May 31. For persistent branches:</p>
+ <ol className="list-decimal pl-5 space-y-1">
+ <li>
+ Take a{' '}
+ <InlineLink href={BACKUP_RESTORE_CLI_URL}>
+ snapshot of the branch database
+ </InlineLink>{' '}
+ before shutting it down.
+ </li>
+ <li>
+ <InlineLink href={BRANCHING_DASHBOARD_URL}>
+ Deploy a new persistent branch
+ </InlineLink>{' '}
+ on Supabase's general infrastructure.
+ </li>
+ <li>Restore your data manually from the snapshot.</li>
+ </ol>
+ </>
+ }
+ />
+
+ <DialogSection className="text-sm">
+ <p>
+ Questions or need an extension? Email{' '}
+ <a className={InlineLinkClassName} href={`mailto:${SUPPORT_EMAIL}`}>
+ {SUPPORT_EMAIL}
+ </a>
+ .
+ </p>
+ </DialogSection>
+
+ <DialogFooter>
+ <DialogClose asChild>
+ <Button type="default">Close</Button>
+ </DialogClose>
+ </DialogFooter>
+ </DialogContent>
+ </Dialog>
+ )
+}
+
+const MAX_LISTED = 5
+
+const ProjectList = ({
+ label,
+ items,
+ instructions,
+}: {
+ label: string
+ items: FlyDeprecationProject[]
+ instructions: ReactNode
+}) => {
+ if (items.length === 0) return null
+ const visible = items.slice(0, MAX_LISTED)
+ const remaining = items.length - visible.length
+ return (
+ <>
+ <DialogSection className="text-sm flex flex-col gap-y-2">
+ <p className="font-medium">
+ {label} ({items.length})
+ </p>
+ {items.length === 1 ? (
+ <p>
+ {items[0].name} <span className="text-foreground-muted">({items[0].orgName})</span>
+ </p>
+ ) : (
+ <ul className="list-disc pl-5 space-y-1">
+ {visible.map((p) => (
+ <li key={p.ref}>
+ {p.name} <span className="text-foreground-muted">({p.orgName})</span>
+ </li>
+ ))}
+ {remaining > 0 && (
+ <li className="text-foreground-muted list-none -ml-5">…and {remaining} more.</li>
+ )}
+ </ul>
+ )}
+ </DialogSection>
+ <DialogSection className="text-sm flex flex-col gap-y-2">{instructions}</DialogSection>
+ </>
+ )
+}
diff --git a/apps/studio/hooks/misc/useFlyDeprecationProjects.ts b/apps/studio/hooks/misc/useFlyDeprecationProjects.ts
new file mode 100644
index 00000000000..c2fc392c87d
--- /dev/null
+++ b/apps/studio/hooks/misc/useFlyDeprecationProjects.ts
@@ -0,0 +1,62 @@
+import { useOrgProjectsInfiniteQuery } from '@/data/projects/org-projects-infinite-query'
+import { useSelectedOrganizationQuery } from '@/hooks/misc/useSelectedOrganization'
+import { useSelectedProjectQuery } from '@/hooks/misc/useSelectedProject'
+import { PROVIDERS } from '@/lib/constants/infrastructure'
+
+export interface FlyDeprecationProject {
+ ref: string
+ name: string
+ orgSlug: string
+ orgName: string
+}
+
+export function useFlyDeprecationProjects({ enabled }: { enabled: boolean }) {
+ const { data: selectedProject } = useSelectedProjectQuery()
+ const { data: selectedOrg } = useSelectedOrganizationQuery()
+
+ const orgSlug = selectedOrg?.slug
+ const orgName = selectedOrg?.name ?? ''
+
+ const { data: orgProjectsData, isFetched } = useOrgProjectsInfiniteQuery(
+ { slug: orgSlug },
+ { enabled: enabled && Boolean(orgSlug), staleTime: 30 * 60 * 1000 }
+ )
+
+ if (!enabled || !orgSlug) {
+ return { isReady: false, primaries: [], branches: [] }
+ }
+
+ const byRef = new Map<string, FlyDeprecationProject & { isBranch: boolean }>()
+
+ if (selectedProject?.cloud_provider === PROVIDERS.FLY.id) {
+ byRef.set(selectedProject.ref, {
+ ref: selectedProject.ref,
+ name: selectedProject.name,
+ orgSlug,
+ orgName,
+ isBranch: Boolean(selectedProject.parent_project_ref),
+ })
+ }
+
+ const orgProjects = orgProjectsData?.pages.flatMap((page) => page.projects) ?? []
+ for (const p of orgProjects) {
+ if (p.cloud_provider !== PROVIDERS.FLY.id) continue
+ if (byRef.has(p.ref)) continue
+ byRef.set(p.ref, {
+ ref: p.ref,
+ name: p.name,
+ orgSlug,
+ orgName,
+ isBranch: Boolean(p.is_branch),
+ })
+ }
+
+ const all = Array.from(byRef.values())
+ const primaries: FlyDeprecationProject[] = []
+ const branches: FlyDeprecationProject[] = []
+ for (const { isBranch, ...rest } of all) {
+ ;(isBranch ? branches : primaries).push(rest)
+ }
+
+ return { isReady: isFetched, primaries, branches }
+}
diff --git a/packages/common/constants/local-storage.ts b/packages/common/constants/local-storage.ts
index ff35f0137ef..aa427c956ff 100644
--- a/packages/common/constants/local-storage.ts
+++ b/packages/common/constants/local-storage.ts
@@ -71,7 +71,7 @@ export const LOCAL_STORAGE_KEYS = {
EXPAND_NAVIGATION_PANEL: 'supabase-expand-navigation-panel',
GITHUB_AUTHORIZATION_STATE: 'supabase-github-authorization-state',
// Notice banner keys
- FLY_POSTGRES_DEPRECATION_WARNING: 'fly-postgres-deprecation-warning-dismissed',
+ FLY_DEPRECATION_2026_05_31: 'fly-deprecation-2026-05-31-dismissed',
API_KEYS_FEEDBACK_DISMISSED: (ref: string) => `supabase-api-keys-feedback-dismissed-${ref}`,
TERMS_OF_SERVICE_UPDATE: 'terms-of-service-update-2026-06-06',
REPORT_DATERANGE: 'supabase-report-daterange',
diff --git a/packages/common/telemetry-constants.ts b/packages/common/telemetry-constants.ts
index 3154ff64a05..58783240a55 100644
--- a/packages/common/telemetry-constants.ts
+++ b/packages/common/telemetry-constants.ts
@@ -3072,6 +3072,36 @@ export interface ComputeBadgeUpgradeClickedEvent {
groups: TelemetryGroups
}
+/**
+ * Fly.io deprecation banner rendered for a user with at least one Fly.io project or branch.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface FlyDeprecationBannerExposedEvent {
+ action: 'fly_deprecation_banner_exposed'
+ groups: TelemetryGroups
+ properties: {
+ primaryCount: number
+ branchCount: number
+ }
+}
+
+/**
+ * User dismissed the Fly.io deprecation banner.
+ *
+ * @group Events
+ * @source studio
+ */
+export interface FlyDeprecationBannerDismissedEvent {
+ action: 'fly_deprecation_banner_dismissed'
+ groups: TelemetryGroups
+ properties: {
+ primaryCount: number
+ branchCount: number
+ }
+}
+
/**
* User dismissed the free Micro upgrade banner.
*
@@ -3583,6 +3613,8 @@ export type TelemetryEvent =
| OrgMenuBackClickedEvent
| OrgMenuItemClickedEvent
| ComputeBadgeUpgradeClickedEvent
+ | FlyDeprecationBannerExposedEvent
+ | FlyDeprecationBannerDismissedEvent
| FreeMicroUpgradeBannerDismissedEvent
| FreeMicroUpgradeBannerCtaClickedEvent
| HeaderUpgradeCtaClickedEvent