EvolveDev Docs

Appearance

How to Integrate with GitHub ​

Connecting your GitHub account is the foundational step to unlocking powerful engineering intelligence with EvolveDev. It allows us to analyze your codebase, pull requests, and core development activities to provide you with meaningful insights.

There are two primary ways to connect your GitHub account, depending on how you choose to sign up:

  • Connecting After Initial Sign-Up: For users who sign up with an email and password.
  • Signing Up Directly with GitHub: For users who want to use GitHub as their primary login method from the start.

Method 1: Connecting GitHub After Initial Sign-Up 📧 ​

If you created your EvolveDev account using your email and password, the platform will immediately guide you to connect your GitHub account as the next step in your onboarding.

The Guided Tour 🗺️ ​

Once you've verified your email and created your EvolveDev Organization, you will be launched into a guided tour to connect your primary data source.

  • 👑 For GitHub Organization Admins: If you have admin permissions for your GitHub organization, this is the recommended path for a complete, team-wide view.

    1. In the guided tour, you will be prompted to connect GitHub.
    2. You will be redirected to GitHub to authorize the EvolveDev.io application.
    3. You will see an option to grant the application access to your entire GitHub organization.
    4. By selecting your organization, you enable EvolveDev to provide insights across all your engineering teams and selected repositories.

  • 🧑‍💻 For Individual Contributors: If you are not an organization admin, or if you simply want to try EvolveDev with your own data first, you can connect your individual account.

    1. When prompted to connect GitHub during the guided tour, proceed to the authorization screen.
    2. Instead of selecting an entire organization, you will authorize EvolveDev for your personal GitHub account.
    3. This will give EvolveDev access to your personal public and private repositories, allowing you to see insights based on your own work and contributions.

Method 2: Signing Up Directly with GitHub 🚀 ​

This is the fastest way to get started if you want to use your GitHub identity as your primary login for EvolveDev.

Step 1: Choose "Sign in with GitHub" ​

On the EvolveDev Sign-Up page, click the "Sign in with GitHub" button 👉.

Step 2: Authenticate and Authorize EvolveDev ​

You will be redirected to GitHub to authorize the EvolveDev.io application.

  • If you are not already logged into GitHub, you will be asked to enter your GitHub email and password.
  • Next, you will see the authorization screen for the EvolveDev app. Here, you have a crucial choice regarding repository access.

Step 3: Choose Repository Permissions 🔐 ​

On the GitHub authorization screen, you can decide which repositories EvolveDev can access:

  • All repositories: This option grants EvolveDev access to all current and future repositories. It's the most convenient option for ensuring complete data coverage as your organization grows.
  • Only select repositories: This option allows you to hand-pick specific repositories for EvolveDev to analyze. You can always add more repositories later from the settings within EvolveDev.

Step 4: Install & Authorize ​

After making your repository selection, click the green "Install & Authorize" button.

Step 5: Create Your EvolveDev Organization ​

Once authorization is complete, you will be brought directly back into the EvolveDev application, landing on a screen where you can create your Organization. This workspace will house all your data and insights.