supabase-upgrade-migration

jeremylongshore's avatarfrom jeremylongshore

Analyze, plan, and execute Supabase SDK upgrades with breaking change detection.Use when upgrading Supabase SDK versions, detecting deprecations,or migrating to new API versions.Trigger with phrases like "upgrade supabase", "supabase migration","supabase breaking changes", "update supabase SDK", "analyze supabase version".

⭐878stars🔀101forks📁View on GitHub🕐Updated Jan 4, 2026
[Developer Tools]

When & Why to Use This Skill

This Claude skill automates the complex process of upgrading the Supabase SDK by analyzing codebases for breaking changes, planning migration paths, and executing updates. It streamlines developer workflows by detecting deprecated APIs and ensuring code integrity through integrated version control and testing validation, significantly reducing the manual effort required for database client maintenance.

Use Cases

  • Major Version Migration: Automatically identify and refactor code affected by breaking changes when upgrading to a new major version of the Supabase SDK, ensuring a seamless transition.
  • Deprecation Auditing: Scan existing projects to detect deprecated Supabase methods and replace them with modern API equivalents to prevent future technical debt and runtime errors.
  • Automated Dependency Management: Use integrated Bash and Git tools to apply SDK updates, run test suites, and manage version control branches during the migration process.
  • Breaking Change Analysis: Generate detailed reports on how new SDK versions will impact current implementation logic before committing to an upgrade.
namesupabase-upgrade-migration
description|
allowed-toolsRead, Write, Edit, Bash(npm:*), Bash(git:*)
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

Supabase Upgrade Migration

Prerequisites

  • Current Supabase SDK installed
  • Git for version control
  • Test suite available
  • Staging environment

See {baseDir}/references/implementation.md for detailed implementation guide.

Output

  • Updated SDK version
  • Fixed breaking changes
  • Passing test suite
  • Documented rollback procedure

Error Handling

See {baseDir}/references/errors.md for comprehensive error handling.

Examples

See {baseDir}/references/examples.md for detailed examples.

Resources