MuseMVP Docs
Social Login

GitHub OAuth

Configure GitHub OAuth login for MuseMVP.

MuseMVP supports GitHub OAuth via Better Auth social providers. Users can sign in or sign up directly with a GitHub account in one click.

Setup Steps

Create a GitHub OAuth App

Go to GitHub Developer Settings and create a new OAuth App.

OAuth App Configuration

Set Authorization callback URL to: <your-site-url>/api/auth/callback/github GitHub OAuth App Callback URL

Client ID and Client Secret

Copy Client ID and generate a Client Secret. GitHub OAuth App Client ID and Client Secret

Add both to .env.

GITHUB_CLIENT_ID="..."
GITHUB_CLIENT_SECRET="..."

Ensure config.auth.gates.allowSocialSignIn is true in src/config/index.ts.


Feature Toggle

Social login can be disabled via configuration:

// src/config/index.ts
auth: {
  gates: {
    allowSocialSignIn: false,  // Disables Google and GitHub
  },
},