supabase-postgres-best-practices

by supabase

Postgres performance optimization rules across 8 priority categories, from query tuning to advanced features. Organized into 8 rule categories prioritized by impact: query performance and connection management (critical), security and RLS, schema design, concurrency, data access patterns, monitoring, and advanced features Each rule includes detailed explanations, incorrect vs. correct SQL examples, EXPLAIN output analysis, and performance metrics to guide optimization decisions Covers query... npx skills add https://github.com/supabase/agent-skills --skill supabase-postgres-best-practices Download ZIPGitHub2.3k

Supabase Postgres Best Practices

Comprehensive performance optimization guide for Postgres, maintained by Supabase. Contains rules across 8 categories, prioritized by impact to guide automated query optimization and schema design.

When to Apply

Reference these guidelines when:

• Writing SQL queries or designing schemas

• Implementing indexes or query optimization

• Reviewing database performance issues

• Configuring connection pooling or scaling

• Optimizing for Postgres-specific features

• Working with Row-Level Security (RLS)

Rule Categories by Priority

Priority Category Impact Prefix 1 Query Performance CRITICAL query- 2 Connection Management CRITICAL conn- 3 Security & RLS CRITICAL security- 4 Schema Design HIGH schema- 5 Concurrency & Locking MEDIUM-HIGH lock- 6 Data Access Patterns MEDIUM data- 7 Monitoring & Diagnostics LOW-MEDIUM monitor- 8 Advanced Features LOW advanced-

References

• https://www.postgresql.org/docs/current/

• https://supabase.com/docs

• https://wiki.postgresql.org/wiki/Performance_Optimization

• https://supabase.com/docs/guides/database/overview

• https://supabase.com/docs/guides/auth/row-level-security