Introduction
## ⚠️ Security Notice
This skill contains Supabase documentation with command examples. Commands are **for reference only** and should NEVER be auto-executed by agents without explicit user approval.
# Supabase Documentation
Complete Supabase platform documentation embedded in markdown. Read from `references/` to answer questions about authentication, database, storage, edge functions, and platform features.
## Documentation Structure
All documentation is in `references/guides/` organized by product:
### Getting Started (`references/guides/getting-started/`) - Quickstart guides - Architecture overview - Framework integrations - Database fundamentals
### Authentication (`references/guides/auth/`) Complete auth system documentation: - Email & password auth - OAuth providers (Google, GitHub, etc.) - Magic links - Phone auth (SMS, WhatsApp) - SSO & SAML - Multi-factor authentication (MFA) - Row Level Security (RLS) - User management - Server-side auth - Redirect URLs - Session management
### Database (`references/guides/database/`) PostgreSQL database features: - Tables and columns - Relationships and foreign keys - Functions and triggers - Extensions - Full-text search - Postgres roles - Replication - Connection pooling - Webhooks - Migrations
### Storage (`references/guides/storage/`) File storage and CDN: - Upload files - Download files - Delete files - List files - Transform images - CDN and caching - Access control with RLS - Resumable uploads
### Edge Functions (`references/guides/functions/`) Serverless functions: - Getting started - Deploy functions - Environment variables - Secrets management - Database access - Auth integration - Logging and monitoring - Cold starts optimization
### Realtime (`references/guides/realtime/`) Realtime subscriptions: - Postgres changes (inserts, updates, deletes) - Broadcast messages - Presence tracking - Authorization
### AI & Embeddings (`references/guides/ai/`) AI and vector features: - Embeddings and vector search - pgvector extension - Similarity search - RAG patterns - AI integrations (OpenAI, etc.)
### Platform (`references/guides/platform/`) Platform management: - Organizations - Projects - Billing - Logs and monitoring - Performance tuning - Backups - Custom domains - SSL certificates
### Self-Hosting (`references/guides/self-hosting/`) Self-hosted Supabase: - Docker setup - Configuration - Monitoring - Backups and restore
### Cron Jobs (`references/guides/cron/`) Scheduled tasks with pg_cron
### Queues (`references/guides/queues/`) Background job queues with pgmq
### Integrations (`references/guides/integrations/`) Third-party integrations and tools
### Local Development (`references/guides/local-development/`) - CLI setup - Local studio - Database migrations - Testing - CI/CD
### Troubleshooting (`references/troubleshooting/`) Common issues and solutions
### Error Codes (`references/errorCodes/`) API and database error reference
## Quick Reference
### Common Tasks
| Task | Directory to Check | |------|-------------------| | Setup Supabase | `guides/getting-started/` | | Email auth | `guides/auth/` | | OAuth providers | `guides/auth/` | | Database schema | `guides/database/` | | RLS policies | `guides/auth/` + `guides/database/` | | File uploads | `guides/storage/` | | Edge functions | `guides/functions/` | | Realtime subscriptions | `guides/realtime/` | | Vector search | `guides/ai/` | | Migrations | `guides/database/` + `guides/local-development/` | | Framework integration | `guides/getting-started/` | | Self-hosting | `guides/self-hosting/` |
### Framework Integrations
Supabase works with: - Next.js (App Router, Pages Router, Server Components) - React (Create React App, Vite) - SvelteKit - Nuxt - Vue - Angular - Flutter - React Native - And more...
### When to Use This Skill
- Setting up Supabase authentication - Database schema design with PostgreSQL - Row Level Security (RLS) policies - File storage and CDN - Edge functions deployment - Realtime subscriptions - Vector search and AI features - Migration from other platforms - Self-hosting Supabase - Performance optimization - Troubleshooting errors
### How to Navigate
1. **Start with `guides/getting-started/`** for setup 2. **For auth:** Browse `guides/auth/` 3. **For database:** Check `guides/database/` 4. **For storage:** See `guides/storage/` 5. **For functions:** Use `guides/functions/` 6. **For realtime:** Check `guides/realtime/` 7. **For AI:** See `guides/ai/` 8. **For errors:** Check `troubleshooting/` and `errorCodes/`
All files are `.mdx` (Markdown + JSX) but readable as plain markdown.