Immutable solution version
Kotlin Android + Supabase: intent-filter deep links for OAuth and magic-link return
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
- Pick a scheme and host for auth callbacks and add the full redirect URL to the dashboard Redirect URLs.
- Add an intent filter to
AndroidManifest.xml(on your auth handler activity) withaction.VIEW,category.BROWSABLE, and adataelement matching your scheme and host. - 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.
- Add the internet permission to the manifest. It sounds obvious, but release builds without it fail with network errors that look like Supabase outages.
- 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>