> **Building with AI coding agents?** If you're using an AI coding agent, install the official Scalekit plugin. It gives your agent full awareness of the Scalekit API — reducing hallucinations and enabling faster, more accurate code generation.
>
> - **Claude Code**: `/plugin marketplace add scalekit-inc/claude-code-authstack` then `/plugin install <auth-type>@scalekit-auth-stack`
> - **GitHub Copilot CLI**: `copilot plugin marketplace add scalekit-inc/github-copilot-authstack` then `copilot plugin install <auth-type>@scalekit-auth-stack`
> - **Codex**: run the bash installer, restart, then open Plugin Directory and enable `<auth-type>`
> - **Skills CLI** (Windsurf, Cline, 40+ agents): `npx skills add scalekit-inc/skills --list` then `--skill <skill-name>`
>
> `<auth-type>` / `<skill-name>`: `agent-auth`, `full-stack-auth`, `mcp-auth`, `modular-sso`, `modular-scim` — [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# GitHub as your sign in option

Scalekit enables apps to easily let users sign in using GitHub as their social connector. This guide walks you through
the process of setting up the connection between Scalekit and GitHub, and using the Scalekit SDK to add "Sign in with
GitHub" to your application.

<figure>
  ![A diagram showing "Your Application" connecting to "Scalekit" via OpenID Connect, which links to GitHub using OAuth 2.0.](@/assets/docs/guides/social-connections/github-1.png)
</figure>

By the end of this guide, you will be able to:

1. Set up an OAuth 2.0 connection between Scalekit and GitHub
2. Scalekit SDK to add "Sign in with GitHub" to your application

## Connect GitHub with Scalekit

**Navigate to social login settings**

Open your Scalekit dashboard and navigate to Social Login under the Authentication section.

<figure>
  ![Scalekit dashboard showcasing social login setup with various platform integration
  options.](@/assets/docs/common/social-connections/1-navigate-to-social-logins.png)
</figure>

**Add a new GitHub connection**

Click the "+ Add Connection" button and select GitHub from the list of available options.

<figure>
  ![Add social login connections: Google, Microsoft, GitHub, Github,
  Salesforce.](@/assets/docs/common/social-connections/2-list-social-logins.png)
  <figcaption>Add social login connections: GitHub</figcaption>
</figure>

## Configure OAuth settings

The OAuth Configuration details page helps you set up the connection:

- Note the **Redirect URI** provided for your app. You'll use this URL to register with GitHub.
- **Client ID** and **Client Secret** are generated by GitHub when you register an OAuth App. They enable Scalekit to
  authenticate your app and establish trust with GitHub.

<figure>
  ![Configure OAuth settings](@/assets/docs/guides/social-connections/github-1.png)
  <figcaption>
    GitHub OAuth configuration in Scalekit, showing redirect URI, client credentials, and scopes for social login setup.
  </figcaption>
</figure>

**Set up GitHub OAuth 2.0**

GitHub lets you set up OAuth through the Microsoft Identity Platform.
<a href="https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app" target="_blank" rel="noopener">Follow GitHub's instructions to set up OAuth 2.0</a>.

1. Navigate to GitHub's OAuth Apps settings page
2. Click "New OAuth App" to create a new application
3. Fill in the application details:
   - Application name: Your app's name
   - Homepage URL: Your application's homepage
   - Application description: Brief description of your app
   - Authorization callback URL: Use the Redirect URI from Scalekit
4. Click "Register application" to create the OAuth App
5. Copy the generated Client ID and Client Secret
6. Paste these credentials into the Scalekit Dashboard
7. Click "Save Changes" in Scalekit to complete the setup
<figure>
  ![GitHub OAuth configuration for social login, showing redirect URI, client ID, and scopes for
  authentication.](@/assets/docs/guides/social-connections/github-1.png)
</figure>

## Test the connection

Click the "Test Connection" button in Scalekit. You will be redirected to the GitHub Consent screen to authorize access.
A summary table will show the information that will be sent to your app.

<figure>
  ![Test connection success](@/assets/docs/guides/social-connections/github-2.png)
</figure>

---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
