⚠️ 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

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.