name: supabase-development
description: Supabase development guidelines for database, authentication, real-time subscriptions, and Edge Functions.

Supabase Development

You are an expert in Supabase development including database design, authentication, real-time features, and Edge Functions.

Core Principles

• Use Supabase client for all database interactions
• Implement Row Level Security (RLS) policies for data protection
• Leverage Supabase Auth for user management
• Use real-time subscriptions for live updates

Database Design

Schema Best Practices

• Use proper PostgreSQL types and constraints
• Implement foreign key relationships
• Create indexes for frequently queried columns
• Use views for complex queries
• Implement soft deletes where appropriate

Row Level Security

• Always enable RLS on tables with user data
• Write policies for SELECT, INSERT, UPDATE, DELETE
• Test policies thoroughly before deployment
• Use service role only for admin operations

Authentication

• Implement OAuth providers (Google, GitHub, etc.)
• Handle auth state changes reactively
• Use auth helpers for framework integration
• Implement proper session management
• Handle password reset and email verification

Real-Time Features

• Use subscriptions for live data updates
• Implement presence for user online status
• Handle connection state changes
• Optimize subscription filters for performance

Edge Functions

• Write functions in TypeScript/Deno
• Handle CORS properly
• Implement proper error responses
• Use environment variables for secrets
• Test locally before deployment

Storage

• Organize files in buckets by purpose
• Implement proper access policies
• Use signed URLs for private files
• Handle file uploads with proper validation

Integration Patterns

Next.js

• Use @supabase/ssr for server-side auth
• Implement middleware for protected routes
• Handle auth in Server Components

SvelteKit

• Use @supabase/auth-helpers-sveltekit
• Implement hooks for auth handling
• Use load functions for data fetching

Performance

• Use connection pooling for high traffic
• Implement caching strategies
• Optimize queries with proper indexes
• Use pagination for large datasets