* fix: rewrite relative URLs when syncing to GitHub discussion Relative URLs back to supabse.com won't work in GitHub discussions, so rewrite them back to absolute URLs starting with https://supabase.com * fix: replace all supabase urls with relative urls * chore: add linting for relative urls * chore: bump linter version * Prettier --------- Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
177 lines
5.2 KiB
Plaintext
177 lines
5.2 KiB
Plaintext
---
|
|
id: 'auth-twitch'
|
|
title: 'Login with Twitch'
|
|
description: 'Add Twitch OAuth to your Supabase project'
|
|
---
|
|
|
|
To enable Twitch Auth for your project, you need to set up a Twitch Application and add the Application OAuth credentials to your Supabase Dashboard.
|
|
|
|
## Overview
|
|
|
|
Setting up Twitch logins for your application consists of 3 parts:
|
|
|
|
- Create and configure a Twitch Application [Twitch Developer Console](https://dev.twitch.tv/console)
|
|
- Add your Twitch OAuth Consumer keys to your [Supabase Project](/dashboard)
|
|
- Add the login code to your [Supabase JS Client App](https://github.com/supabase/supabase-js)
|
|
|
|
## Access your Twitch Developer account
|
|
|
|
- Go to [dev.twitch.tv](https://dev.twitch.tv).
|
|
- Click on `Log in with Twitch` at the top right to log in.
|
|
- If you have not already enabled 2-Factor Authentication for your Twitch Account, you will need to do that at [Twitch Security Settings](https://www.twitch.tv/settings/security) before you can continue.
|
|
|
|

|
|
|
|
- Once logged in, go to the [Twitch Developer Console](https://dev.twitch.tv/console).
|
|
|
|

|
|
|
|
## Find your callback URL
|
|
|
|
<$Partial path="social_provider_setup.mdx" variables={{ "provider": "Twitch" }} />
|
|
|
|
## Create a Twitch application
|
|
|
|

|
|
|
|
- Click on `+ Register Your Application` at the top right.
|
|
|
|

|
|
|
|
- Enter the name of your application.
|
|
- Type or paste your `OAuth Redirect URL` (the callback URL from the previous step.)
|
|
- Select a category for your app.
|
|
- Check the CAPTCHA box and click `Create`.
|
|
|
|
## Retrieve your Twitch OAuth client ID and client secret
|
|
|
|
- Click `Manage` at the right of your application entry in the list.
|
|
|
|

|
|
|
|
- Copy your Client ID.
|
|
- Click `New Secret` to create a new Client Secret.
|
|
- Copy your Client Secret.
|
|
|
|

|
|
|
|
## Add your Twitch credentials into your Supabase project
|
|
|
|
<$Partial path="social_provider_settings_supabase.mdx" variables={{ "provider": "Twitch" }} />
|
|
|
|
## Add login code to your client app
|
|
|
|
<Tabs
|
|
scrollable
|
|
size="small"
|
|
type="underlined"
|
|
defaultActiveId="js"
|
|
queryGroup="language"
|
|
>
|
|
<TabPanel id="js" label="JavaScript">
|
|
|
|
<$Partial path="create_client_snippet.mdx" />
|
|
|
|
When your user signs in, call [`signInWithOAuth()`](/docs/reference/javascript/auth-signinwithoauth) with `twitch` as the `provider`:
|
|
|
|
```js
|
|
import { createClient } from '@supabase/supabase-js'
|
|
const supabase = createClient('<your-project-url>', '<sb_publishable_... or anon key>')
|
|
|
|
// ---cut---
|
|
async function signInWithTwitch() {
|
|
const { data, error } = await supabase.auth.signInWithOAuth({
|
|
provider: 'twitch',
|
|
})
|
|
}
|
|
```
|
|
|
|
</TabPanel>
|
|
<TabPanel id="flutter" label="Flutter">
|
|
|
|
When your user signs in, call [`signInWithOAuth()`](/docs/reference/dart/auth-signinwithoauth) with `twitch` as the `provider`:
|
|
|
|
```dart
|
|
Future<void> signInWithTwitch() async {
|
|
await supabase.auth.signInWithOAuth(
|
|
OAuthProvider.twitch,
|
|
redirectTo: kIsWeb ? null : 'my.scheme://my-host', // Optionally set the redirect link to bring back the user via deeplink.
|
|
authScreenLaunchMode:
|
|
kIsWeb ? LaunchMode.platformDefault : LaunchMode.externalApplication, // Launch the auth screen in a new webview on mobile.
|
|
);
|
|
}
|
|
```
|
|
|
|
</TabPanel>
|
|
<$Show if="sdk:kotlin">
|
|
<TabPanel id="kotlin" label="Kotlin">
|
|
|
|
When your user signs in, call [signInWith(Provider)](/docs/reference/kotlin/auth-signinwithoauth) with `Twitch` as the `Provider`:
|
|
|
|
```kotlin
|
|
suspend fun signInWithTwitch() {
|
|
supabase.auth.signInWith(Twitch)
|
|
}
|
|
```
|
|
|
|
</TabPanel>
|
|
</$Show>
|
|
</Tabs>
|
|
|
|
<$Partial path="oauth_pkce_flow.mdx" />
|
|
|
|
<Tabs
|
|
scrollable
|
|
size="small"
|
|
type="underlined"
|
|
defaultActiveId="js"
|
|
queryGroup="language"
|
|
>
|
|
<TabPanel id="js" label="JavaScript">
|
|
|
|
When your user signs out, call [signOut()](/docs/reference/javascript/auth-signout) to remove them from the browser session and any objects from localStorage:
|
|
|
|
```js
|
|
import { createClient } from '@supabase/supabase-js'
|
|
const supabase = createClient('<your-project-url>', '<sb_publishable_... or anon key>')
|
|
|
|
// ---cut---
|
|
async function signOut() {
|
|
const { error } = await supabase.auth.signOut()
|
|
}
|
|
```
|
|
|
|
</TabPanel>
|
|
<TabPanel id="flutter" label="Flutter">
|
|
|
|
When your user signs out, call [signOut()](/docs/reference/dart/auth-signout) to remove them from the browser session and any objects from localStorage:
|
|
|
|
```dart
|
|
Future<void> signOut() async {
|
|
await supabase.auth.signOut();
|
|
}
|
|
```
|
|
|
|
</TabPanel>
|
|
<$Show if="sdk:kotlin">
|
|
<TabPanel id="kotlin" label="Kotlin">
|
|
|
|
When your user signs out, call [signOut()](/docs/reference/kotlin/auth-signout) to remove them from the browser session and any objects from localStorage:
|
|
|
|
```kotlin
|
|
suspend fun signOut() {
|
|
supabase.auth.signOut()
|
|
}
|
|
```
|
|
|
|
</TabPanel>
|
|
</$Show>
|
|
</Tabs>
|
|
|
|
## Resources
|
|
|
|
- [Supabase - Get started for free](https://supabase.com)
|
|
- [Supabase JS Client](https://github.com/supabase/supabase-js)
|
|
- [Twitch Account](https://twitch.tv)
|
|
- [Twitch Developer Console](https://dev.twitch.tv/console)
|