supabase / supabase-flutter / 27146471618
85%

DEFAULT BRANCH: main
Ran
Jobs 1
Files 72
Run time 1min
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
coverage: 80.471%. Remained the same
27146471618

push

github

web-flow 
docs: update facebook native login docs (#1322)

## What kind of change does this PR introduce?

Docs update

## What is the current behavior?

Currently, there is no official documentation for Facebook native login
using signInWithIdToken in the Flutter SDK. Many developers refer to
external tutorials or guess the implementation and mistakenly pass the
Facebook Graph API access token (e.g., result.accessToken!.tokenString)
as the idToken parameter.

Because the Supabase GoTrue backend strictly expects an OpenID Connect
(OIDC) ID token (Facebook Limited Login JWT), passing the Graph API
access token throws a 400 Bad ID token error. Furthermore, developers
don't know they need to request OIDC tokens by using
LoginBehavior.webOnly on Android or extracting the authenticationToken
field properly.

Resolves #1287 Resolves #987 (Addresses problems seen in PR #1297)

## What is the new behavior?

This PR updates packages/supabase_flutter/README.md to include:

Native Facebook Login Example: A complete, robust example of using the
flutter_facebook_auth package to perform native login. It shows how to
correctly enforce OIDC token generation (LoginBehavior.webOnly on
Android) and how to safely extract the OIDC token by checking if the
result is a ClassicToken (extracting authenticationToken) or a
LimitedToken (extracting tokenString).
Web-based OAuth Alternative: Adds a secondary snippet showing how to use
signInWithOAuth as a simpler web-based fallback if developers choose not
to use the native Facebook SDK.

##Additional context

This is a documentation-only update. It provides the necessary context
and exact implementation details to avoid backend validation errors
related to Facebook's dual-token system (Graph API vs Limited Login
OIDC).
The [website
docs](https://supabase.com/docs/reference/dart/auth-signinwithidtoken)
also needs to be updated to reflect this docs.

3556 of 4419 relevant lines covered (80.47%)

2.91 hits per line

Jobs
ID Job ID Ran Files Coverage
1 27146471618.1 72
80.47
 GitHub Action Run
Source Files on build 27146471618