Flutter: Sign in with a passkey

Signs the user in with a passkey (WebAuthn).

• Available on supabase_flutter 2.15.0 and later as an extension on GoTrueClient.
• Drives the full WebAuthn ceremony end to end: starts the challenge with the Supabase server, calls the authenticator you supply to prompt the user for biometrics or a security key, and verifies the credential with the server.
• Does not require an existing session. On success the session is persisted and an AuthChangeEvent.signedIn event is fired.
• supabase_flutter does not depend on a passkey plugin directly. Pass an implementation of PasskeyAuthenticatorInterface, such as the passkeys plugin's PasskeyAuthenticator (since passkeys 2.21.0).
• For native flows or custom UI, use the lower-level auth.passkey namespace instead.
• Passkeys are a BETA feature and must be enabled for your project in the Supabase Dashboard under Authentication > Configuration > Passkeys.
• Platform setup the library cannot perform (Associated Domains on iOS/macOS, Digital Asset Links on Android, the passkeys web SDK on web) is documented in the supabase_flutter package README.

Parameters

• authenticator

  (Required)

  Performs the platform passkey ceremony (FaceID/TouchID/security key). For example, a `PasskeyAuthenticator` from the `passkeys` package.

• captchaToken

  (Optional)

  Captcha token to be used for captcha verification.

Examples

Sign in with a passkey

import 'package:passkeys/authenticator.dart';

final authenticator = PasskeyAuthenticator();

final AuthResponse res = await supabase.auth.signInWithPasskey(authenticator);
final Session? session = res.session;
final User? user = res.user;