How do I add a GitHub connector?

Short Answer:
Go to Settings > Connectors, click Add connector, choose GitHub App (Recommended) or GitHub OAuth, click Connect, complete the GitHub authorization, then confirm the connector shows Connected in the table.

Answer

Prerequisites

1. Be signed in to Everdone

2. Open Settings > Connectors

3. Have a GitHub account (with access to the repos you want to connect)

4. For GitHub App installs: you need organization owner or admin access on GitHub

Steps

1. In Everdone, open Settings > Connectors.

2. Click Add connector.

3. Under Connect using: select GitHub App (Recommended) or GitHub OAuth.

4. Click Connect to start the GitHub flow.

5. In GitHub, approve the requested permissions (and select the org/repos if prompted).

6. Return to Everdone and verify the connector appears in the Connectors table with Status: Connected (columns typically include Account, Type, Status, Last synced).

Troubleshooting

1. I can’t install the GitHub App.

   • Likely Cause: App installs require GitHub organization owner/admin permissions.

   • Action: Ask an owner/admin to install the App, or use GitHub OAuth instead.

2. Connect doesn’t finish or shows an error.

   • Likely Cause: GitHub authorization was denied or not completed.

   • Action: Re-run Connect and complete all GitHub prompts (authorize/install, select org/repos).

3. I don’t see the Add connector button.

   • Likely Cause: You’re not on the Connectors page.

   • Action: Open Settings > Connectors and try again.

Notes

• The GitHub App path offers finer-grained, organization-level control and is recommended.

• The connect modal explicitly states the admin requirement for App installs.