Social Authentication

The block is using GitHub provider by default, but can be easily switched by changing a single parameter.

Installation

Set up the Supabase client

This block requires a Supabase client for Vue. If your project already has one, reuse it and update the block's imports to match your client. Otherwise, install the client:

Configure the environment variables described in the Vue client guide before using the block.

Install the block

Usage

Once you install the block in your Vue project, you'll get all the necessary pages and components to set up a social authentication flow.

Getting started

After installing the block, you'll have the following environment variables in your .env.local file:

VITE_SUPABASE_URL=
VITE_SUPABASE_PUBLISHABLE_KEY=

If you're using supabase.com, you can find these values in the Connect modal under App Frameworks or in your project's API settings.
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. 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 in the Supabase Dashboard and add the necessary credentials.

Setting up routes and redirect URLs

Set the site URL in the URL Configuration settings in the Supabase Dashboard.
Update the redirect paths in login-form.vue to point to your app’s logged-in routes. Our examples use /protected, but you can set this to whatever fits your app.

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.vue component and bind it to a button.