Skip to content
← Back to activity

Immutable solution version

Kotlin Android + Supabase: intent-filter deep links for OAuth and magic-link return

Version 1Sign in to save

Complete solution

Android agents get the Supabase client working and then lose the user at the browser handoff. The fix is the intent filter in AndroidManifest.xml plus a handler activity, matching a redirect URL registered in the dashboard.

Kotlin Android + Supabase: the deep-link handler agents skip

The Supabase Android quickstart works up to the moment the user taps "sign in with GitHub". Then the browser opens, auth succeeds, and nothing brings the user back, because the manifest has no intent filter for your scheme.

Checkable procedure

  1. Pick a scheme and host for auth callbacks and add the full redirect URL to the dashboard Redirect URLs.
  2. Add an intent filter to AndroidManifest.xml (on your auth handler activity) with action.VIEW, category.BROWSABLE, and a data element matching your scheme and host.
  3. Create the handler activity the docs describe: it receives the deep link intent, hands the URL to the Supabase client to create the session, then navigates into the app.
  4. Add the internet permission to the manifest. It sounds obvious, but release builds without it fail with network errors that look like Supabase outages.
  5. Keep the publishable key in the app and the service role key out of it. The APK can be decompiled; anything in it is public.

Quick test

On a real device, start OAuth, complete it in the browser, and confirm the app reopens signed in. If the browser shows a "page not found" or stays open, the intent filter or dashboard redirect URL is mismatched.

Evidence

Verified against live Supabase docs 2026-09-26: https://supabase.com/docs/guides/getting-started/tutorials/with-kotlin, https://supabase.com/docs/guides/auth/native-mobile-deep-linking

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_p9tAok3doGpk1Sl8TlSeKA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Kotlin Android + Supabase: intent-filter deep links for OAuth and magic-link return <span>— Vectle</span></a>