mirror of
https://github.com/supabase/supabase.git
synced 2026-10-08 19:05:06 +03:00
Ivan VasilovandTerry Sutton
2ebf81c601
* Add social login block. * Regen the registry. * Fix the nextjs social auth. * Add social auth blocks for RR, Tanstack and React. * Minor fixes. * Add docs. * Update the docs. * Minor fixes to the blocks. * Update the docs. * Fix various doc issues. * Fix the redirect in the password-based auth. * Fix note about supabase clients in docs. * Use with instead of assert in the registry imports. * Update all auth blocks to use /protected. * Update all docs for the password-based auth. * Add new label to social auth. * Fix docs issues. * Light mode fix * Smol fixes * Fix the origin in the login route. * Add social auth to the landing page. * Regenerate the registry. --------- Co-authored-by: Terry Sutton <saltcod@gmail.com>
58 lines
2.6 KiB
Plaintext
58 lines
2.6 KiB
Plaintext
---
|
||
title: Social Authentication
|
||
description: Social authentication block for React Single Page Applications
|
||
---
|
||
|
||
<BlockPreview name="social-auth/auth/login" />
|
||
|
||
<Callout className="mt-4">
|
||
The block is using Github provider by default, but can be easily switched by changing a single
|
||
parameter.
|
||
</Callout>
|
||
|
||
## Installation
|
||
|
||
<BlockItem name="social-auth-react" description="All needed components for the social auth flow" />
|
||
|
||
## Folder structure
|
||
|
||
This block includes the [Supabase client](/ui/docs/react/client). If you already have one installed, you can skip overwriting it.
|
||
|
||
<RegistryBlock itemName="social-auth-react" />
|
||
|
||
## Usage
|
||
|
||
Once you install the block in your React project, you'll get all the necessary pages and components to set up a social authentication flow.
|
||
|
||
### Getting started
|
||
|
||
First, add a `.env` file to your project with the following environment variables:
|
||
|
||
```env
|
||
VITE_SUPABASE_URL=
|
||
VITE_SUPABASE_ANON_KEY=
|
||
```
|
||
|
||
- If you're using supabase.com, you can find these values in the [Connect modal](https://supabase.com/dashboard/project/_?showConnect=true) under App Frameworks or in your project's [API settings](https://supabase.com/dashboard/project/_/settings/api).
|
||
|
||
- If you're using a local instance of Supabase, you can find these values by running `supabase start` or `supabase status` (if you already have it running).
|
||
|
||
### Setting up third party providers
|
||
|
||
We support a wide variety of social providers that you can use to integrate with your application. The full list is available [here](https://supabase.com/docs/guides/auth/social-login).
|
||
This block uses the implicit flow with GitHub as the provider. To switch providers, just update the `provider` field in the `supabase.auth.signInWithOAuth` call. Enable the provider you want to use under [Auth Providers](https://supabase.com/dashboard/project/_/auth/providers) in the Supabase Dashboard and add the necessary credentials.
|
||
|
||
### Setting up routes and redirect URLs
|
||
|
||
1. Set the site URL in the [URL Configuration](https://supabase.com/dashboard/project/_/auth/url-configuration) settings in the Supabase Dashboard.
|
||
1. Update the redirect paths in `login-form.tsx` to point to your app’s logged-in routes. Our examples use `/protected`, but you can set this to whatever fits your app.
|
||
|
||
### Combining social auth with password-based auth
|
||
|
||
If you want to combine this block with the password-based auth, you need to copy the `handleSocialLogin` function into the password-based `login-form.tsx` component and bind it to a button.
|
||
|
||
## Further reading
|
||
|
||
- [Social login](https://supabase.com/docs/guides/auth/social-login)
|
||
- [Authentication error codes](https://supabase.com/docs/guides/auth/debugging/error-codes)
|