supabase-js

# Supabase JavaScript SDK Skill Skill for building applications with the `@supabase/supabase-js` SDK. Covers Auth, Database (PostgREST), Storage, Realtime, and Edge Functions. The SDK docs at https://supabase.com/docs/reference/javascript are the source of truth. The reference files alongside this skill contain source code and READMEs extracted from the monorepo for quick lookup. ## Setup ```bash npm install @supabase/supabase-js ``` ```typescript import { createClient } from '@supabase/supabase-js' const supabase = createClient('https://xyzcompany.supabase.co', 'public-anon-key') ``` For type-safe queries, generate types from your database schema: ```bash supabase gen types typescript --project-id your-project-id > database.types.ts ``` ```typescript import { createClient } from '@supabase/supabase-js' import type { Database } from './database.types' const supabase = createClient<Database>(SUPABASE_URL, SUPABASE_ANON_KEY) ``` ## Quick Decision Trees ### "I need to query data" ``` Database query? ├─ Select rows → supabase.from('table').select('*') ├─ Filter rows → .select().eq('col', val) / .gt() / .lt() / .in() / .like() ├─ Join tables → .select('*, other_table(*)') or .select('*, other_table!fk(*)') ├─ Insert → supabase.from('table').insert({ col: val }) ├─ Upsert → supabase.from('table').upsert({ id: 1, col: val }) ├─ Update → supabase.from('table').update({ col: val }).eq('id', 1) ├─ Delete → supabase.from('table').delete().eq('id', 1) ├─ Call RPC function → ...