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".
/plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills/plugin install supabase-pack@claude-code-plugins-plusThis skill is limited to using the following tools:
Guide for upgrading Supabase SDK versions and handling breaking changes.
npm list @supabase/supabase-js
npm view @supabase/supabase-js version
open https://github.com/supabase/sdk/releases
git checkout -b upgrade/supabase-sdk-vX.Y.Z
npm install @supabase/supabase-js@latest
npm test
Update import statements, configuration, and method signatures as needed.
| SDK Version | API Version | Node.js | Breaking Changes |
|---|---|---|---|
| 3.x | 2024-01 | 18+ | Major refactor |
| 2.x | 2023-06 | 16+ | Auth changes |
| 1.x | 2022-01 | 14+ | Initial release |
// Before (v1.x)
import { Client } from '@supabase/supabase-js';
// After (v2.x)
import { SupabaseClient } from '@supabase/supabase-js';
// Before (v1.x)
const client = new Client({ key: 'xxx' });
// After (v2.x)
const client = new SupabaseClient({
apiKey: 'xxx',
});
npm install @supabase/supabase-js@1.x.x --save-exact
// Monitor for deprecation warnings in development
if (process.env.NODE_ENV === 'development') {
process.on('warning', (warning) => {
if (warning.name === 'DeprecationWarning') {
console.warn('[Supabase]', warning.message);
// Log to tracking system for proactive updates
}
});
}
// Common deprecation patterns to watch for:
// - Renamed methods: client.oldMethod() -> client.newMethod()
// - Changed parameters: { key: 'x' } -> { apiKey: 'x' }
// - Removed features: Check release notes before upgrading
For CI integration during upgrades, see supabase-ci-integration.