Skip to content
Kitbay

studio-error-handling

Apache-2.0Updated on Nov 11, 2026114,826GitHub stars

A maintainer skill in the Supabase monorepo describing how Supabase Studio classifies, reports and displays errors.

What the skill teaches

A maintainer skill in the Supabase monorepo describing how Supabase Studio classifies, reports and displays errors. A fetch helper matches error messages against known patterns and throws tagged error classes that record who is at fault and whether a retry makes sense; components never match text themselves. Classifier functions handle API responses, other failures and SQL errors, and user-written SQL is never sent to Sentry. The skill says which component to use: an alert for failed queries, a matcher with troubleshooting steps for known error types, and a toast for failed mutations. It lists the key files and mistakes to avoid, and points to the error-handling README.

Capabilities

  • Classify Studio errors into tagged error classes
  • Pick the right error component for a failure
  • Add troubleshooting steps for a new error type
  • Keep user-written SQL out of error reports