Skip to content

@capgo/capacitor-supabase

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

@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.

  • 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.
ConcernRecommended path
AuthenticationUse @capgo/capacitor-supabase.
Session persistence and refreshUse @capgo/capacitor-supabase.
Advanced database queriesUse @supabase/supabase-js with the native JWT.
Realtime, Storage, Edge FunctionsUse @supabase/supabase-js.

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

If you are using @capgo/capacitor-supabase to plan security and compliance, connect it with Encryption for the implementation detail in Encryption, Compliance for the implementation detail in Compliance, Capgo Security Scanner for the product workflow in Capgo Security Scanner, Capgo Security for the product workflow in Capgo Security, and Capgo Trust Center for the product workflow in Capgo Trust Center.