remove impact and impactDescription from supabase skills frontmatter header

This commit is contained in:
Pedro Rodrigues
2026-02-16 15:32:50 +00:00
parent 8e39a3cac7
commit e53ba93011
89 changed files with 8 additions and 198 deletions

View File

@@ -100,7 +100,7 @@ function parseSectionsFromFile(filePath: string): Section[] {
const sections: Section[] = []; const sections: Section[] = [];
const sectionMatches = content.matchAll( const sectionMatches = content.matchAll(
/##\s+(\d+)\.\s+([^\n(]+)\s*\((\w+)\)\s*\n\*\*Impact:\*\*\s*(\w+(?:-\w+)?)\s*\n\*\*Description:\*\*\s*([^\n]+)/g, /##\s+(\d+)\.\s+([^\n(]+)\s*\((\w+)\)\s*\n(?:\*\*Impact:\*\*\s*(\w+(?:-\w+)?)\s*\n)?\*\*Description:\*\*\s*([^\n]+)/g,
); );
for (const match of sectionMatches) { for (const match of sectionMatches) {
@@ -108,7 +108,7 @@ function parseSectionsFromFile(filePath: string): Section[] {
number: parseInt(match[1], 10), number: parseInt(match[1], 10),
title: match[2].trim(), title: match[2].trim(),
prefix: match[3].trim(), prefix: match[3].trim(),
impact: match[4].trim() as Section["impact"], impact: match[4]?.trim() as Section["impact"],
description: match[5].trim(), description: match[5].trim(),
}); });
} }

View File

@@ -237,11 +237,11 @@ export function parseRuleFile(
return { success: false, errors, warnings }; return { success: false, errors, warnings };
} }
// Get impact level // Validate impact level when provided
const impact = frontmatter.impact as ImpactLevel; const impact = frontmatter.impact as ImpactLevel | undefined;
if (!impact || !IMPACT_LEVELS.includes(impact)) { if (impact && !IMPACT_LEVELS.includes(impact)) {
errors.push( errors.push(
`Invalid or missing impact level: ${impact}. Must be one of: ${IMPACT_LEVELS.join(", ")}`, `Invalid impact level: ${impact}. Must be one of: ${IMPACT_LEVELS.join(", ")}`,
); );
return { success: false, errors, warnings }; return { success: false, errors, warnings };
} }

View File

@@ -19,7 +19,7 @@ export interface Rule {
title: string; title: string;
section: number; section: number;
subsection?: number; subsection?: number;
impact: ImpactLevel; impact?: ImpactLevel;
impactDescription?: string; impactDescription?: string;
explanation: string; explanation: string;
examples: CodeExample[]; examples: CodeExample[];
@@ -32,7 +32,7 @@ export interface Section {
number: number; number: number;
title: string; title: string;
prefix: string; prefix: string;
impact: ImpactLevel; impact?: ImpactLevel;
description: string; description: string;
} }

View File

@@ -11,7 +11,6 @@ import {
import { import {
discoverSkills, discoverSkills,
getSkillPaths, getSkillPaths,
IMPACT_LEVELS,
type SkillPaths, type SkillPaths,
validateSkillExists, validateSkillExists,
} from "./config.js"; } from "./config.js";
@@ -123,20 +122,6 @@ export function validateRuleFile(
} }
} }
// Validate impact level
if (!IMPACT_LEVELS.includes(rule.impact)) {
errors.push(
`Invalid impact level: ${rule.impact}. Must be one of: ${IMPACT_LEVELS.join(", ")}`,
);
}
// Warning for missing impact description
if (!rule.impactDescription) {
warnings.push(
"Missing impactDescription (recommended for quantifying benefit)",
);
}
return { return {
valid: errors.length === 0, valid: errors.length === 0,
errors, errors,

View File

@@ -7,35 +7,28 @@ queries.
## 1. Authentication (auth) ## 1. Authentication (auth)
**Impact:** CRITICAL
**Description:** Sign-up, sign-in, sign-out, session management, OAuth/social login, SAML SSO, MFA, passwordless flows, auth hooks, and server-side auth patterns. **Description:** Sign-up, sign-in, sign-out, session management, OAuth/social login, SAML SSO, MFA, passwordless flows, auth hooks, and server-side auth patterns.
## 2. Database (db) ## 2. Database (db)
**Impact:** CRITICAL
**Description:** Row Level Security policies, connection pooling, schema design patterns, migrations, performance optimization, and security functions for Supabase Postgres. **Description:** Row Level Security policies, connection pooling, schema design patterns, migrations, performance optimization, and security functions for Supabase Postgres.
## 3. Development (dev) ## 3. Development (dev)
**Impact:** CRITICAL
**Description:** Getting started with Supabase, CLI command reference, MCP server setup and tools, when to use CLI vs MCP, and development workflows for local and remote environments. **Description:** Getting started with Supabase, CLI command reference, MCP server setup and tools, when to use CLI vs MCP, and development workflows for local and remote environments.
## 4. Edge Functions (edge) ## 4. Edge Functions (edge)
**Impact:** HIGH
**Description:** Fundamentals, authentication, database access, CORS, routing, error handling, streaming, WebSockets, regional invocations, testing, and limits. **Description:** Fundamentals, authentication, database access, CORS, routing, error handling, streaming, WebSockets, regional invocations, testing, and limits.
## 5. SDK (sdk) ## 5. SDK (sdk)
**Impact:** HIGH
**Description:** supabase-js client initialization, TypeScript generation, CRUD queries, filters, joins, RPC calls, error handling, performance, and Next.js integration. **Description:** supabase-js client initialization, TypeScript generation, CRUD queries, filters, joins, RPC calls, error handling, performance, and Next.js integration.
## 6. Realtime (realtime) ## 6. Realtime (realtime)
**Impact:** MEDIUM-HIGH
**Description:** Channel setup, Broadcast messaging, Presence tracking, Postgres Changes listeners, cleanup patterns, error handling, and debugging. **Description:** Channel setup, Broadcast messaging, Presence tracking, Postgres Changes listeners, cleanup patterns, error handling, and debugging.
## 7. Storage (storage) ## 7. Storage (storage)
**Impact:** HIGH
**Description:** File uploads (standard and resumable), downloads, signed URLs, image transformations, CDN caching, access control with RLS policies, and file management operations. **Description:** File uploads (standard and resumable), downloads, signed URLs, image transformations, CDN caching, access control with RLS policies, and file management operations.

View File

@@ -1,7 +1,5 @@
--- ---
title: Manage Auth Sessions Correctly title: Manage Auth Sessions Correctly
impact: CRITICAL
impactDescription: Session mismanagement causes auth failures, security issues, and poor UX
tags: auth, sessions, tokens, refresh, onAuthStateChange, jwt tags: auth, sessions, tokens, refresh, onAuthStateChange, jwt
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Implement Sign-In and Password Reset title: Implement Sign-In and Password Reset
impact: CRITICAL
impactDescription: Core authentication flows - mistakes lead to security issues or locked-out users
tags: auth, signin, login, password-reset, email tags: auth, signin, login, password-reset, email
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Implement Secure User Sign-Up title: Implement Secure User Sign-Up
impact: CRITICAL
impactDescription: Foundation of user registration - mistakes lead to security vulnerabilities or broken flows
tags: auth, signup, registration, email-confirmation, user-metadata tags: auth, signup, registration, email-confirmation, user-metadata
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Add Custom Claims to JWT via Auth Hooks title: Add Custom Claims to JWT via Auth Hooks
impact: HIGH
impactDescription: Custom claims enable role-based access without database lookups in every request
tags: auth, hooks, jwt, claims, rbac, roles, permissions tags: auth, hooks, jwt, claims, rbac, roles, permissions
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Send Email Hook via HTTP (Edge Function) title: Send Email Hook via HTTP (Edge Function)
impact: MEDIUM
impactDescription: Custom email hooks enable branded templates and third-party email providers
tags: auth, hooks, email, templates, resend, edge-functions, http tags: auth, hooks, email, templates, resend, edge-functions, http
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Send Email Hook via SQL (PostgreSQL Function) title: Send Email Hook via SQL (PostgreSQL Function)
impact: MEDIUM
impactDescription: Queue-based email sending with PostgreSQL for batch processing and reliability
tags: auth, hooks, email, postgresql, pg_cron, sql, queue tags: auth, hooks, email, postgresql, pg_cron, sql, queue
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Implement Phone-Based MFA title: Implement Phone-Based MFA
impact: MEDIUM-HIGH
impactDescription: Phone MFA provides alternative second factor for users without authenticator apps
tags: auth, mfa, phone, sms, whatsapp, 2fa tags: auth, mfa, phone, sms, whatsapp, 2fa
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Implement TOTP Multi-Factor Authentication title: Implement TOTP Multi-Factor Authentication
impact: HIGH
impactDescription: MFA significantly reduces account compromise risk
tags: auth, mfa, totp, 2fa, security, authenticator tags: auth, mfa, totp, 2fa, security, authenticator
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Implement PKCE Flow for OAuth title: Implement PKCE Flow for OAuth
impact: HIGH
impactDescription: PKCE prevents authorization code interception attacks in SPAs
tags: auth, oauth, pkce, spa, code-exchange, security tags: auth, oauth, pkce, spa, code-exchange, security
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Configure OAuth Social Providers title: Configure OAuth Social Providers
impact: HIGH
impactDescription: Social login increases conversion - misconfiguration breaks authentication
tags: auth, oauth, social-login, google, github, apple, azure tags: auth, oauth, social-login, google, github, apple, azure
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Implement Magic Link Authentication title: Implement Magic Link Authentication
impact: MEDIUM-HIGH
impactDescription: Passwordless login improves UX and security - magic links are the most common approach
tags: auth, passwordless, magic-link, email, otp tags: auth, passwordless, magic-link, email, otp
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Implement Email and Phone OTP title: Implement Email and Phone OTP
impact: MEDIUM-HIGH
impactDescription: OTP codes avoid link prefetching issues and work better for mobile apps
tags: auth, passwordless, otp, email, phone, sms tags: auth, passwordless, otp, email, phone, sms
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Use Admin Auth API Securely title: Use Admin Auth API Securely
impact: CRITICAL
impactDescription: Admin API bypasses RLS - misuse exposes all data and enables account takeover
tags: auth, admin, service-role, server, security, user-management tags: auth, admin, service-role, server, security, user-management
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Implement SSR Authentication title: Implement SSR Authentication
impact: CRITICAL
impactDescription: SSR auth mistakes cause auth failures, security issues, and hydration mismatches
tags: auth, ssr, server, nextjs, sveltekit, nuxt, cookies tags: auth, ssr, server, nextjs, sveltekit, nuxt, cookies
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Configure SAML 2.0 SSO title: Configure SAML 2.0 SSO
impact: MEDIUM
impactDescription: Enterprise SSO enables organizations to use their identity providers
tags: auth, sso, saml, enterprise, okta, azure-ad, identity-provider tags: auth, sso, saml, enterprise, okta, azure-ad, identity-provider
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Use Correct Connection Pooling Mode title: Use Correct Connection Pooling Mode
impact: CRITICAL
impactDescription: Prevents connection exhaustion and enables 10-100x scalability
tags: connection-pooling, supavisor, transaction-mode, session-mode tags: connection-pooling, supavisor, transaction-mode, session-mode
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Use npx supabase db diff for Dashboard Changes title: Use npx supabase db diff for Dashboard Changes
impact: HIGH
impactDescription: Captures manual changes into version-controlled migrations
tags: migrations, supabase-cli, db-diff, dashboard tags: migrations, supabase-cli, db-diff, dashboard
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Write Idempotent Migrations title: Write Idempotent Migrations
impact: HIGH
impactDescription: Safe to run multiple times, prevents migration failures
tags: migrations, idempotent, supabase-cli tags: migrations, idempotent, supabase-cli
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Test Migrations with supabase db reset title: Test Migrations with supabase db reset
impact: MEDIUM-HIGH
impactDescription: Catch migration errors before production deployment
tags: migrations, testing, supabase-cli, local-development tags: migrations, testing, supabase-cli, local-development
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Choose the Right Index Type title: Choose the Right Index Type
impact: CRITICAL
impactDescription: 10-1000x query performance improvements with proper indexing
tags: indexes, performance, btree, brin, gin, partial tags: indexes, performance, btree, brin, gin, partial
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Optimize Queries for PostgREST title: Optimize Queries for PostgREST
impact: HIGH
impactDescription: Faster API responses and reduced database load
tags: postgrest, queries, performance, optimization, supabase-js tags: postgrest, queries, performance, optimization, supabase-js
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Avoid Common RLS Policy Mistakes title: Avoid Common RLS Policy Mistakes
impact: CRITICAL
impactDescription: Prevents security vulnerabilities and unintended data exposure
tags: rls, security, auth.uid, policies, common-mistakes tags: rls, security, auth.uid, policies, common-mistakes
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Enable RLS on All Exposed Schemas title: Enable RLS on All Exposed Schemas
impact: CRITICAL
impactDescription: Prevents unauthorized data access at the database level
tags: rls, security, auth, policies tags: rls, security, auth, policies
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Optimize RLS Policy Performance title: Optimize RLS Policy Performance
impact: CRITICAL
impactDescription: Achieve 100x-99,000x query performance improvements
tags: rls, performance, optimization, indexes, auth.uid tags: rls, performance, optimization, indexes, auth.uid
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Use RESTRICTIVE vs PERMISSIVE Policies title: Use RESTRICTIVE vs PERMISSIVE Policies
impact: MEDIUM-HIGH
impactDescription: Controls policy combination logic to prevent unintended access
tags: rls, policies, permissive, restrictive tags: rls, policies, permissive, restrictive
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Use security_invoker for Views with RLS title: Use security_invoker for Views with RLS
impact: HIGH
impactDescription: Ensures views respect RLS policies instead of bypassing them
tags: rls, views, security_invoker, security tags: rls, views, security_invoker, security
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Add CASCADE to auth.users Foreign Keys title: Add CASCADE to auth.users Foreign Keys
impact: HIGH
impactDescription: Prevents orphaned records and user deletion failures
tags: foreign-keys, auth.users, cascade, schema-design tags: foreign-keys, auth.users, cascade, schema-design
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Install Extensions in extensions Schema title: Install Extensions in extensions Schema
impact: MEDIUM
impactDescription: Keeps public schema clean and simplifies migrations
tags: extensions, schema-design, best-practices tags: extensions, schema-design, best-practices
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Use Structured Columns Over JSONB When Possible title: Use Structured Columns Over JSONB When Possible
impact: MEDIUM
impactDescription: Improves query performance, type safety, and data integrity
tags: jsonb, json, schema-design, performance tags: jsonb, json, schema-design, performance
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Realtime Requires Primary Keys title: Realtime Requires Primary Keys
impact: MEDIUM-HIGH
impactDescription: Prevents Realtime subscription failures and data sync issues
tags: realtime, primary-keys, subscriptions tags: realtime, primary-keys, subscriptions
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Always Use timestamptz Not timestamp title: Always Use timestamptz Not timestamp
impact: MEDIUM-HIGH
impactDescription: Prevents timezone-related bugs and data inconsistencies
tags: timestamps, timestamptz, timezone, data-types tags: timestamps, timestamptz, timezone, data-types
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Use security_definer Functions in Private Schema title: Use security_definer Functions in Private Schema
impact: HIGH
impactDescription: Controlled privilege escalation without exposing service role
tags: functions, security_definer, security, private-schema tags: functions, security_definer, security, private-schema
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Never Expose Service Role Key to Browser title: Never Expose Service Role Key to Browser
impact: CRITICAL
impactDescription: Prevents complete database compromise and data breach
tags: service-role, security, api-keys, anon-key tags: service-role, security, api-keys, anon-key
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: CLI Command Reference title: CLI Command Reference
impact: CRITICAL
impactDescription: Best practices and pitfalls for every CLI command group
tags: cli, commands, push, pull, diff, reset, migration, functions, secrets, types tags: cli, commands, push, pull, diff, reset, migration, functions, secrets, types
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: CLI + psql vs MCP Decision Guide title: CLI + psql vs MCP Decision Guide
impact: CRITICAL
impactDescription: Prevents agents from using wrong tool for each operation and environment
tags: cli, psql, mcp, decision, tool-selection, local, remote, sdk tags: cli, psql, mcp, decision, tool-selection, local, remote, sdk
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Getting Started with Supabase title: Getting Started with Supabase
impact: CRITICAL
impactDescription: Required setup for any new Supabase project — blocks all other development
tags: setup, init, start, install, docker, link, psql tags: setup, init, start, install, docker, link, psql
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Local Development Workflow title: Local Development Workflow
impact: CRITICAL
impactDescription: Standard development cycle using local Supabase stack with CLI, psql, and supabase-js
tags: local, development, workflow, iteration, docker, psql, cli, sdk tags: local, development, workflow, iteration, docker, psql, cli, sdk
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Supabase Remote MCP Server Setup title: Supabase Remote MCP Server Setup
impact: CRITICAL
impactDescription: Required configuration for remote database interaction, debugging, and advisors via MCP
tags: mcp, setup, configuration, oauth, security, remote, cursor, claude-code, vscode, windsurf, codex, gemini, goose, factory, opencode, kiro tags: mcp, setup, configuration, oauth, security, remote, cursor, claude-code, vscode, windsurf, codex, gemini, goose, factory, opencode, kiro
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: MCP Tool Reference title: MCP Tool Reference
impact: CRITICAL
impactDescription: Complete reference for all Supabase MCP tools used to interact with remote projects
tags: mcp, execute_sql, apply_migration, get_logs, get_advisors, deploy_edge_function, branching, storage, remote, tools tags: mcp, execute_sql, apply_migration, get_logs, get_advisors, deploy_edge_function, branching, storage, remote, tools
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Remote Development Workflow title: Remote Development Workflow
impact: CRITICAL
impactDescription: Development workflow for interacting with hosted Supabase projects
tags: remote, hosted, workflow, deploy, link, mcp tags: remote, hosted, workflow, deploy, link, mcp
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Regional Invocations title: Regional Invocations
impact: LOW-MEDIUM
impactDescription: Optimizes latency for region-specific workloads
tags: edge-functions, regions, latency, performance tags: edge-functions, regions, latency, performance
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Streaming Responses title: Streaming Responses
impact: MEDIUM
impactDescription: Enables real-time data delivery and AI response streaming
tags: edge-functions, streaming, sse, server-sent-events tags: edge-functions, streaming, sse, server-sent-events
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: WebSocket Handling title: WebSocket Handling
impact: MEDIUM
impactDescription: Enables bidirectional real-time communication
tags: edge-functions, websockets, realtime, bidirectional tags: edge-functions, websockets, realtime, bidirectional
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: JWT Verification and Authentication title: JWT Verification and Authentication
impact: CRITICAL
impactDescription: Prevents unauthorized access and security vulnerabilities
tags: edge-functions, jwt, authentication, jose, security tags: edge-functions, jwt, authentication, jose, security
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: RLS Integration in Edge Functions title: RLS Integration in Edge Functions
impact: HIGH
impactDescription: Ensures proper data isolation and security enforcement
tags: edge-functions, rls, row-level-security, auth-context tags: edge-functions, rls, row-level-security, auth-context
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Direct Postgres Connections title: Direct Postgres Connections
impact: MEDIUM
impactDescription: Enables complex queries and ORM usage
tags: edge-functions, postgres, drizzle, connection-pooling tags: edge-functions, postgres, drizzle, connection-pooling
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Database Access with supabase-js title: Database Access with supabase-js
impact: HIGH
impactDescription: Primary method for database operations with RLS support
tags: edge-functions, database, supabase-js, queries tags: edge-functions, database, supabase-js, queries
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Limits and Troubleshooting title: Limits and Troubleshooting
impact: HIGH
impactDescription: Prevents production failures and debugging bottlenecks
tags: edge-functions, limits, debugging, troubleshooting tags: edge-functions, limits, debugging, troubleshooting
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Testing Edge Functions title: Testing Edge Functions
impact: MEDIUM
impactDescription: Ensures reliability before production deployment
tags: edge-functions, testing, deno, unit-tests tags: edge-functions, testing, deno, unit-tests
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Project Structure and Organization title: Project Structure and Organization
impact: HIGH
impactDescription: Proper organization reduces cold starts and improves maintainability
tags: edge-functions, structure, shared, organization tags: edge-functions, structure, shared, organization
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Edge Functions Quick Start title: Edge Functions Quick Start
impact: CRITICAL
impactDescription: Foundation for all Edge Function development
tags: edge-functions, quickstart, deployment, cli, deno tags: edge-functions, quickstart, deployment, cli, deno
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Background Tasks title: Background Tasks
impact: MEDIUM-HIGH
impactDescription: Enables fast responses for long-running operations
tags: edge-functions, background, waituntil, async tags: edge-functions, background, waituntil, async
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: CORS Configuration title: CORS Configuration
impact: HIGH
impactDescription: Required for browser-based function invocation
tags: edge-functions, cors, browser, preflight tags: edge-functions, cors, browser, preflight
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Error Handling Patterns title: Error Handling Patterns
impact: MEDIUM
impactDescription: Improves reliability and debugging experience
tags: edge-functions, errors, debugging, client-errors tags: edge-functions, errors, debugging, client-errors
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Routing and Multi-Route Functions title: Routing and Multi-Route Functions
impact: MEDIUM-HIGH
impactDescription: Reduces cold starts and simplifies API architecture
tags: edge-functions, routing, hono, url-pattern tags: edge-functions, routing, hono, url-pattern
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Send and Receive Broadcast Messages title: Send and Receive Broadcast Messages
impact: HIGH
impactDescription: Core pattern for real-time client-to-client messaging
tags: realtime, broadcast, send, receive, subscribe tags: realtime, broadcast, send, receive, subscribe
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Broadcast from Database Triggers title: Broadcast from Database Triggers
impact: CRITICAL
impactDescription: Scalable pattern for notifying clients of database changes
tags: realtime, broadcast, database, triggers, realtime.send, realtime.broadcast_changes tags: realtime, broadcast, database, triggers, realtime.send, realtime.broadcast_changes
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Clean Up Channels to Prevent Memory Leaks title: Clean Up Channels to Prevent Memory Leaks
impact: CRITICAL
impactDescription: Prevents memory leaks and connection quota exhaustion
tags: realtime, cleanup, react, lifecycle, removeChannel tags: realtime, cleanup, react, lifecycle, removeChannel
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Debug Realtime Connections title: Debug Realtime Connections
impact: MEDIUM
impactDescription: Enables visibility into connection and message flow issues
tags: realtime, debugging, logging, troubleshooting tags: realtime, debugging, logging, troubleshooting
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Handle Realtime Errors and Connection Issues title: Handle Realtime Errors and Connection Issues
impact: HIGH
impactDescription: Enables graceful handling of connection failures
tags: realtime, errors, subscribe, status, reconnection tags: realtime, errors, subscribe, status, reconnection
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Listen to Database Changes with Postgres Changes title: Listen to Database Changes with Postgres Changes
impact: MEDIUM
impactDescription: Simple database change listeners with scaling limitations
tags: realtime, postgres_changes, database, subscribe, publication tags: realtime, postgres_changes, database, subscribe, publication
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Track User Presence and Online Status title: Track User Presence and Online Status
impact: MEDIUM
impactDescription: Enables features like online indicators and typing status
tags: realtime, presence, track, online, state tags: realtime, presence, track, online, state
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Configure Private Channels with Authentication title: Configure Private Channels with Authentication
impact: CRITICAL
impactDescription: Prevents unauthorized access to real-time messages
tags: realtime, auth, private, rls, security, setAuth tags: realtime, auth, private, rls, security, setAuth
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Create and Configure Realtime Channels title: Create and Configure Realtime Channels
impact: HIGH
impactDescription: Proper channel setup enables reliable real-time communication
tags: realtime, channels, configuration, topics, naming tags: realtime, channels, configuration, topics, naming
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Browser Client Setup title: Browser Client Setup
impact: CRITICAL
impactDescription: Prevents session conflicts and memory leaks from multiple client instances
tags: createBrowserClient, singleton, client-side, ssr, supabase-js tags: createBrowserClient, singleton, client-side, ssr, supabase-js
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Client Configuration Options title: Client Configuration Options
impact: MEDIUM-HIGH
impactDescription: Enables custom auth storage, fetch behavior, and schema selection
tags: configuration, auth, fetch, storage, schema, react-native tags: configuration, auth, fetch, storage, schema, react-native
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Server Client and Proxy Setup title: Server Client and Proxy Setup
impact: CRITICAL
impactDescription: Prevents auth bypass and ensures session refresh works correctly
tags: createServerClient, proxy, cookies, ssr, server-components tags: createServerClient, proxy, cookies, ssr, server-components
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Error Handling Patterns title: Error Handling Patterns
impact: MEDIUM-HIGH
impactDescription: Prevents runtime errors and enables proper error recovery
tags: error, error-handling, retry, FunctionsHttpError, try-catch tags: error, error-handling, retry, FunctionsHttpError, try-catch
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Next.js App Router Integration title: Next.js App Router Integration
impact: HIGH
impactDescription: Enables proper SSR auth with session refresh and type-safe queries
tags: nextjs, app-router, server-components, proxy, ssr tags: nextjs, app-router, server-components, proxy, ssr
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Query Performance Optimization title: Query Performance Optimization
impact: HIGH
impactDescription: Reduces data transfer and improves response times
tags: performance, optimization, select, parallel, Promise.all, explain tags: performance, optimization, select, parallel, Promise.all, explain
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Realtime Performance and Cleanup title: Realtime Performance and Cleanup
impact: HIGH
impactDescription: Prevents memory leaks and ensures reliable subscriptions
tags: realtime, subscriptions, cleanup, channels, broadcast, postgres-changes tags: realtime, subscriptions, cleanup, channels, broadcast, postgres-changes
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: CRUD Operations title: CRUD Operations
impact: HIGH
impactDescription: Core database operations with proper return handling
tags: select, insert, update, delete, upsert, crud tags: select, insert, update, delete, upsert, crud
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Filters and Modifiers title: Filters and Modifiers
impact: HIGH
impactDescription: Enables precise data retrieval with proper filter ordering
tags: filters, eq, neq, in, like, order, limit, range, modifiers tags: filters, eq, neq, in, like, order, limit, range, modifiers
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Joins and Relations title: Joins and Relations
impact: HIGH
impactDescription: Enables efficient data fetching with related tables in a single query
tags: joins, relations, foreign-tables, nested-select, inner-join tags: joins, relations, foreign-tables, nested-select, inner-join
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: RPC - Calling Postgres Functions title: RPC - Calling Postgres Functions
impact: MEDIUM
impactDescription: Enables complex server-side logic via Postgres functions
tags: rpc, postgres-functions, stored-procedures, plpgsql tags: rpc, postgres-functions, stored-procedures, plpgsql
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Generate TypeScript Types title: Generate TypeScript Types
impact: HIGH
impactDescription: Enables compile-time type safety for all database operations
tags: typescript, types, codegen, supabase-cli, database.types.ts tags: typescript, types, codegen, supabase-cli, database.types.ts
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Using TypeScript Types title: Using TypeScript Types
impact: HIGH
impactDescription: Provides type-safe access to tables, enums, and complex query results
tags: typescript, Tables, Enums, QueryData, type-helpers tags: typescript, Tables, Enums, QueryData, type-helpers
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Configure Storage Access Control title: Configure Storage Access Control
impact: CRITICAL
impactDescription: Prevents unauthorized file access and upload failures
tags: storage, buckets, public, private, rls, policies, security tags: storage, buckets, public, private, rls, policies, security
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Understand CDN Caching and Stale Content title: Understand CDN Caching and Stale Content
impact: HIGH
impactDescription: Prevents serving outdated files after updates
tags: storage, cdn, caching, cache-control, stale-content, smart-cdn tags: storage, cdn, caching, cache-control, stale-content, smart-cdn
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Choose the Right Download Method title: Choose the Right Download Method
impact: MEDIUM
impactDescription: Ensures correct file access for public and private content
tags: storage, download, signed-url, public-url, getPublicUrl tags: storage, download, signed-url, public-url, getPublicUrl
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Manage Files Through the API title: Manage Files Through the API
impact: MEDIUM
impactDescription: Prevents orphaned files and billing issues
tags: storage, delete, move, copy, list, operations tags: storage, delete, move, copy, list, operations
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Transform Images On-the-Fly title: Transform Images On-the-Fly
impact: MEDIUM
impactDescription: Reduces bandwidth with server-side image transformations
tags: storage, images, transform, resize, webp, optimization tags: storage, images, transform, resize, webp, optimization
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Use Resumable Uploads for Large Files title: Use Resumable Uploads for Large Files
impact: HIGH
impactDescription: Enables reliable upload of large files with progress and resume
tags: storage, upload, large-files, tus, resumable, multipart tags: storage, upload, large-files, tus, resumable, multipart
--- ---

View File

@@ -1,7 +1,5 @@
--- ---
title: Use Standard Uploads for Small Files title: Use Standard Uploads for Small Files
impact: HIGH
impactDescription: Ensures reliable uploads for files under 6MB
tags: storage, upload, small-files, upsert, signed-upload tags: storage, upload, small-files, upsert, signed-upload
--- ---