Does it support Python projects?

Yes, it includes support for upgrading the Python supabase package, specifically handling the shift from dictionary access to attribute access introduced in version 2.0+.

Can I revert if the upgrade causes issues?

Yes, the skill provides a detailed rollback procedure, including specific commands to pin to previous versions and git-based branch reverts.

What breaking changes does this skill handle?

It primarily addresses the v1 to v2 shift in @supabase/supabase-js, including async auth methods like getSession(), the new Channel API for Realtime, and split Auth methods such as signInWithPassword().

How does it verify the migration was successful?

The skill performs type checks using tsc, executes existing test suites, and provides a manual smoke test checklist for critical auth, storage, and realtime flows.

Does it update TypeScript database types?

Yes, it can trigger the Supabase CLI to regenerate TypeScript definitions directly from your linked project schema to ensure type safety after a migration.

Supabase Upgrade Migration

Name: Supabase Upgrade Migration
Author: jeremylongshore

byjeremylongshore

•

1,887

•

Gestión de Bases de Datos

Automates the process of upgrading Supabase SDKs and CLI versions while managing breaking changes and code transformations.

This skill facilitates seamless upgrades for Supabase implementations, specifically targeting the transition from v1 to v2 of the JavaScript SDK and updates to the Python library. It identifies breaking changes in authentication, realtime subscriptions, and storage APIs, providing automated code replacements and rollback strategies to ensure application stability. By handling complex migrations—such as the shift from synchronous to asynchronous auth methods and the move to channel-based realtime APIs—it minimizes manual refactoring effort and prevents common upgrade-related bugs during maintenance cycles.

Características Principales

01Automated TypeScript type regeneration from live database schemas

021,887 GitHub stars

03Automated migration of v1 to v2 breaking changes in @supabase/supabase-js

04Detection and refactoring of legacy Auth, Realtime, and Storage API calls

05Support for Python Supabase SDK upgrades with attribute-access migration

06Structured rollback planning and post-upgrade verification testing

Casos de Uso

01Modernizing a legacy Supabase v1 project to the latest stable v2 architecture

02Upgrading the Supabase CLI and regenerating database types for a CI/CD pipeline

03Migrating from legacy auth-helpers to the modern @supabase/ssr package

Características Principales

01Automated TypeScript type regeneration from live database schemas

021,887 GitHub stars

03Automated migration of v1 to v2 breaking changes in @supabase/supabase-js

04Detection and refactoring of legacy Auth, Realtime, and Storage API calls

05Support for Python Supabase SDK upgrades with attribute-access migration

06Structured rollback planning and post-upgrade verification testing

Casos de Uso

01Modernizing a legacy Supabase v1 project to the latest stable v2 architecture

02Upgrading the Supabase CLI and regenerating database types for a CI/CD pipeline

03Migrating from legacy auth-helpers to the modern @supabase/ssr package