> ## Documentation Index
> Fetch the complete documentation index at: https://vlyai-1c28d863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OAuth login

> Add Google, GitHub, or other OAuth providers as a sign-in option.

Add a "Sign in with X" button to your existing app. Standard pattern across providers.

**Time:** \~10 min per provider. **Difficulty:** Beginner.

## Steps

<Steps>
  <Step title="Register an OAuth app at the provider">
    Get a Client ID and Client Secret. See [OAuth providers](/features/auth/oauth-providers) for per-provider links.
  </Step>

  <Step title="Set the redirect URL at the provider">
    `https://your-app.vly.app/api/auth/callback/{provider}` — vly shows the exact URL.
  </Step>

  <Step title="Configure in vly">
    Workspace settings → Auth → Providers → \[provider] → paste credentials.
  </Step>

  <Step title="Toggle on">
    The provider button appears on your sign-in / sign-up pages.
  </Step>
</Steps>

## Foundation prompt (if no auth yet)

```text theme={null}
Add Google OAuth as a sign-in option. Use the workspace's existing OAuth
configuration. Show the "Sign in with Google" button on the sign-in page,
above the email + password form.
```

## Related

<CardGroup cols={3}>
  <Card title="OAuth providers" icon="key" href="/features/auth/oauth-providers">
    Per-provider setup.
  </Card>

  <Card title="Built-in auth" icon="lock" href="/features/auth/built-in-auth">
    The auth system.
  </Card>

  <Card title="Auth flows" icon="key-round" href="/architecture/auth-flows">
    Patterns.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.