Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

supabase

/supabase

Wspiera pracę z Supabase: PostgreSQL, RLS, Edge Functions, Auth i pgvector przy budowie aplikacji z API REST i GraphQL.

Repozytorium
Agent-Skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
01.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 01.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wspiera pracę z Supabase: PostgreSQL, RLS, Edge Functions, Auth i pgvector przy budowie aplikacji z API REST i GraphQL.

Oryginalny opis (EN)

Expert Supabase assistance covering PostgreSQL, Row Level Security (RLS), Edge Functions, Auth, and pgvector. Use when building full-stack web/mobile applications with Postgres backends and instant REST/GraphQL APIs.

Jak działa

  1. When to Use
  2. Quick Start
  3. Core Concepts
  4. Common Patterns
  5. Best Practices
  6. Troubleshooting
  7. References
Sekcje z nagłówków SKILL.md, w oryginale · 137 linii, 643 słów
Podgląd SKILL.md
---
name: supabase
description: Expert Supabase assistance covering PostgreSQL, Row Level Security (RLS), Edge Functions, Auth, and pgvector. Use when building full-stack web/mobile applications with Postgres backends and instant REST/GraphQL APIs.
---

# Supabase

Supabase is an open source Firebase alternative. It provides a dedicated PostgreSQL database, packaged with Authentication, Realtime subscriptions, Storage, and Edge Functions.

## When to Use

- **Open-Source Firebase Alternative**: Complete backend-as-a-service providing PostgreSQL, Auth, Realtime, Storage, and Edge Functions.
- **Full Relational PostgreSQL Power**: Direct access to real PostgreSQL with extensions (pgvector, PostGIS, pg_cron) and zero proprietary vendor lock-in.
- **Row-Level Security (RLS) Authorization**: Securing multi-tenant client queries directly at the database layer via SQL security policies.
- **Real-Time Database Subscriptions**: Subscribing to PostgreSQL insert, update, and delete events over WebSockets from client apps.

## Quick Start

```javascript
import { createClient } from "@supabase/supabase-js";

const supabase = createClient("https://xyz.supabase.co", "public-anon-key");

// Listen to changes
const subscription = supabase
  .channel("public:messages")
  .on(
    "postgres_changes",
    { event: "INSERT", schema: "public", table: "messages" },
    (payload) => {
      console.log("New message:", payload);
    },
  )
  .subscribe();
```

## Core Concepts

### PostgreSQL Row-Level Security (RLS)

Protects data at the database layer so clients can query the database directly from web/mobile apps safely:

```sql
-- Enable RLS on Table
ALTER TABLE documents ENABLE ROW LEVEL SECURITY;

-- Allow users to read and update only documents they own
CREATE POLICY "Users access own documents"
ON documents
FOR ALL
USING (auth.uid() = user_id)
WITH CHECK (auth.uid() = user_id);
```

### Modern Supabase JavaScript / TypeScript Client

Type-safe database queries, authentication, and file storage:

```typescript
import { createClient } from "@supabase/supabase-js";
import { Database } from "./types/supabase";

const supabase = createClient<Database>(
  process.env.SUPABASE_URL!,
  process.env.SUPABASE_ANON_KEY!,
);

// Query with automated RLS enforcement
const { data: projects, error } = await supabase
  .from("projects")
  .select("id, title, tasks(id, name, status)")
  .eq("status", "active")
  .order("created_at", { ascending: false });
```

### Real-Time WebSocket Broadcasts & Presence

Streams live changes and synchronizes user presence states:

```typescript
// Subscribe to real-time database changes on orders table
const channel = supabase
  .channel("db-changes")
  .on(
    "postgres_changes",
    { event: "INSERT", schema: "public", table: "orders" },
    (payload) => {
      console.log("New Order Created:", payload.new);
    },
  )
  .subscribe();
```

## Common Patterns

### Row Level Security (RLS) Policy for Multi-Tenant Isolation

**Problem**: APIs accidentally leaking private user records when client queries lack manual tenant filtering.

**Solution**:
Enforce database-level Row Level Security using `auth.uid()`:

```sql
-- Enable RLS
ALTER TABLE user_notes ENABLE ROW LEVEL SECURITY;

-- Restrict reads and writes exclusively to the owning user
CREATE POLICY "Users can only access own notes"
ON user_notes
FOR ALL
USING (auth.uid() = user_id)
WITH CHECK (auth.uid() = user_id);
```

## Best Practices

**Do**:

- Always Enable Row-Level Security (RLS): Never expose a table to the public API without enabling and testing RLS policies.
- Generate Strict TypeScript Types: Use the Supabase CLI (`supabase gen types typescript`) to keep database schemas strongly typed.
- Index Columns Used in RLS Policies: Add indexes on `user_id` or `organization_id` to prevent slow table scans during policy evaluations.
- Use Edge Functions for Sensitive Logic: Keep private API secrets and payment integrations inside server-side Edge Functions.

**Don't**:

- Expose the `service_role` key in client code: The `service_role` key bypasses all RLS policies; keep it strictly on secure servers.
- Write complex nested subqueries in RLS policies: Slow RLS subqueries multiply latency on every single row check.
- Skip database migrations in Git: Use `supabase migration new` and version control all database DDL changes.

## Troubleshooting

| Error                                       | Cause                                                                     | Solution                                                                              |
| :------------------------------------------ | :------------------------------------------------------------------------ | :------------------------------------------------------------------------------------ |
| `Empty array [] returned from SELECT query` | RLS is enabled on table but no policy matches current authenticated user. | Create appropriate RLS policy or verify client JWT token contains valid user session. |
| `JWT expired / Invalid refresh token`       | User session token expired without refreshing.                            | Call `supabase.auth.refreshSession()` or handle auth state change listener.           |
| `Database connection limit exceeded`        | Serverless edge functions exceeding direct Postgres connections.          | Use Supabase connection pooling (port 6543) via PgBouncer.                            |

## References

- [Supabase Docs](https://supabase.com/docs)

Wersje

RepozytoriumWynikLicencja
Ta strona · G1Joshi/Agent-Skills100MIT
ericrisco/rsc-harness100MIT
TerminalSkills/skills100Apache-2.0
magnus919/agent-skills100MIT
gianpaj/sexyvoice100Apache-2.0
PracticalSwan/agent-skills100MIT
aAAaqwq/AGI-Super-Team100MIT
tdealer01-crypto/tdealer01-crypto-dsg-control-plane100Apache-2.0
andersonlimahw/lemon-ai-hub100MIT

Migawka bazy z 13.11.2026 · wersja paczki c511b7db6f96 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 85Supabase Expert
    Pomaga w integracji Supabase: schematy baz, polityki RLS, uwierzytelnianie, Edge Functions i subskrypcje w czasie rzeczywistym.
  • 100supabase-postgres-auth-storage
    Buduje serwerowe aplikacje na Supabase Postgres z RLS i Realtime, obejmując uwierzytelnianie, przechowywanie plików i zabezpieczenia.
  • 100supabase-admin
    Obsługuje administrację Supabase: polityki RLS, migracje, projekt schematu oraz strojenie wydajności bazy z integracją uwierzytelniania.
  • 100supabase-admin
    Obsługuje administrację Supabase: polityki RLS, migracje, projekt schematu oraz strojenie wydajności bazy z integracją uwierzytelniania.
  • 100supabase-expert
    Buduje bezpieczne aplikacje Supabase: polityki Row Level Security jako warstwa autoryzacji, schemat względem auth.users, Edge Functions, Realtime i wersjonowane migracje.
  • 90postgres-schema-rls
    Projektuje schematy PostgreSQL, indeksy i bezpieczeństwo wierszy na podstawie jawnych kontraktów dostępu, również dla Supabase.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.