Erste Schritte

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-supabase`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/supabase/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installieren

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:

bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Nutze dann diesen Prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-supabase` plugin in my project.

Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

bun add @capgo/capacitor-supabase
bunx cap sync

Quickstart

import { CapacitorSupabase } from '@capgo/capacitor-supabase';

await CapacitorSupabase.initialize({
  supabaseUrl: 'https://xyzcompany.supabase.co',
  supabaseKey: 'your-anon-key'
});

Beispiel: signInWithPassword

import { CapacitorSupabase } from '@capgo/capacitor-supabase';

const { session, user } = await CapacitorSupabase.signInWithPassword({
  email: 'user@example.com',
  password: 'password123'
});
console.log('JWT:', session?.accessToken);

import { CapacitorSupabase } from '@capgo/capacitor-supabase';

const { session, user } = await CapacitorSupabase.signUp({
  email: 'newuser@example.com',
  password: 'password123',
  data: { name: 'John Doe' }
});

Häufige Stolperfallen

Listener: Handles beim Unmounten von Screens entfernen.
Einmalige Initialisierung: Setup beim App-Bootstrap ausführen.
Single Source of Truth: Vertrauen src/definitions.ts im GitHub Repo.

Android-Mindestversion SDK

Die Android-Implementierung erfordert Android 8.0 oder neuer. Setze minSdkVersion = 26 in einem android/variables.gradle.

Client initialisieren

import { CapacitorSupabase } from '@capgo/capacitor-supabase';

await CapacitorSupabase.initialize({
  supabaseUrl: 'https://your-project.supabase.co',
  supabaseKey: 'your-anon-key',
});

const { session, user } = await CapacitorSupabase.signInWithPassword({
  email: 'user@example.com',
  password: 'password123',
});

console.log('User', user?.id);
console.log('JWT available', Boolean(session?.accessToken));

Auth-Änderungen abonnieren

const listener = await CapacitorSupabase.addListener('authStateChange', ({ event, session }) => {
  console.log('Auth event', event);
  console.log('Current JWT available', Boolean(session?.accessToken));
});

await listener.remove();

Native Auth mit supabase-js kombinieren

import { createClient } from '@supabase/supabase-js';

const { session } = await CapacitorSupabase.getSession();

const supabase = createClient('https://your-project.supabase.co', 'your-anon-key', {
  global: {
    headers: {
      Authorization: `Bearer ${session?.accessToken}`,
    },
  },
});

const { data } = await supabase.from('table').select('*');
console.log(data);

Native Datenbank-Helfer

const { data, error } = await CapacitorSupabase.select({
  table: 'users',
  columns: 'id, name, email',
  filter: { active: true },
  limit: 10,
  orderBy: 'created_at',
  ascending: false,
});

console.log(data, error);

Empfohlene Nutzung

Nutze dieses Plugin für Authentifizierung und Session-Management.
Behalten Sie Realtime, Storage, Edge Functions und fortgeschrittene Abfragen in @supabase/supabase-js.
Übergeben Sie das native JWT an den JavaScript-Client, wann immer Sie den restlichen Supabase-Bereich benötigen.

Weiter geht's nach Getting Started

Wenn du es nutzt Erste Schritte Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails unter „Plugins hinzufügen oder aktualisieren“, Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow in Ionic Enterprise Plugin-Alternativen und Capgo Native Builds optimieren für den Produkt-Workflow in Capgo Native Builds.