@capgo/capacitor-supabase

Use native Supabase authentication in Capacitor while still pairing it with @supabase/supabase-js where it makes sense.

Overview

@capgo/capacitor-supabase focuses on the parts where native Supabase SDKs give Capacitor apps real value: authentication flows, session persistence, token refresh, and direct JWT access.

Use the plugin for native auth and session management, then pass the native JWT to @supabase/supabase-js for Realtime, Storage, Edge Functions, and advanced querying.

Core Capabilities

Native Supabase client initialization.
Email/password sign-in and sign-up.
OTP, magic link, OAuth, and session helpers.
Native auth state listeners.
JWT access for JavaScript or backend calls.
Basic native select, insert, update, and delete helpers.

Recommended Architecture

Concern	Recommended path
Authentication	Use `@capgo/capacitor-supabase`.
Session persistence and refresh	Use `@capgo/capacitor-supabase`.
Advanced database queries	Use `@supabase/supabase-js` with the native JWT.
Realtime, Storage, Edge Functions	Use `@supabase/supabase-js`.

Source Of Truth

This reference is synced from src/definitions.ts in capacitor-supabase.