Github

Need a hand? Setting up developer credentials can sometimes feel a bit overwhelming. We offer a complimentary 15-minute onboarding session to help you get this configured perfectly. Book your session with a specialist here

When you first install Bread & Butter, the GitHub 1-click connection may not display your own branding during the connection process if it is not fully configured for your domain.

To maximize user trust and prevent conversion drop-off, you must set up an OAuth application within your GitHub account. This allows you to generate your own credentials so your visitors see your brand when they click "Continue with GitHub."

Here is how to set it up in four steps.

Step 1: Create Your GitHub App

1. Log in to your standard Github account.
   • https://github.com/
2. Navigate to your Developer Settings to begin creating an OAuth app. (If you are unsure where to find this, you can follow https://docs.github.com/en/developers/apps/creating-an-oauth-app).

Step 2: Configure Your App Details

This ensures GitHub displays your branding and correctly routes your users back to your website after they authenticate.

3. For the Application name, we highly recommend using your exact organization or company name, as this is what will appear to users during the login process.
4. For the Homepage URL, enter your organization's main website address.
5. Under the Authorization callback URL field, paste the following exact link: https://api.breadbutter.io/callback  
6. Click Register application to save your configuration.

Step 3: Generate Your App Credentials

7. Once your app is registered, you will be taken to the App details page.
8. Locate your Client ID and generate a Client Secret.

⚠️ Important: Copy and save both of these values immediately. You will need them to connect Bread & Butter in the final step.

Step 4: Link Your Credentials to Bread & Butter

9. Log in to your Bread & Butter dashboard.
   • https://app.breadbutter.io
10. Go to Settings in the left menu, then navigate to your Global Conversion Methods tab.
11. Locate your Github connection and edit the settings to switch from Sandbox to Production Mode.
12. Enter a custom name and description for your reference.
13. Paste the Client ID and Client Secret you generated in GitHub.
14. Click Save, and ensure the checkbox next to your new GitHub provider is enabled.

Final Polish: Complete Your White-Label Setup

You have successfully added your brand name to the Google consent screen! However, visitors may still see breadbutter.io  listed in the URL routing during the connection process.

To completely remove our branding and keep visitors fully within your own domain ecosystem, navigate to the Custom Auth Domain tab in your Bread & Butter settings to set up your Custom Auth Domain.

• For more information, see: What is a Custom Auth Domain, and how do I set it up?