GitHub App Setup
Connect your GitHub repositories to GitProductivity.
GitHub App Setup
This guide walks you through connecting your GitHub repositories to GitProductivity.
Prerequisites
Before connecting GitHub, ensure you have:
- A GitHub account with repository access
- Admin or Maintain permissions for the repositories you want to connect
- At least one existing repository
Connecting GitHub
Navigate to Integrations
Go to your dashboard and click Integrations in the sidebar, then select GitHub.
Authorize GitHub App
Click Connect GitHub to authorize our GitHub app. You'll be redirected to GitHub's authorization page.
We request only the minimum permissions required to analyze your repositories.
Select Repositories
After authorization, you'll see a list of your accessible repositories. Select the repositories you want to analyze and click Connect.
Wait for Initial Sync
GitProductivity will begin syncing your repository data. This may take several minutes depending on:
- Number of repositories
- Repository size (commits, branches)
- Git history depth
Permissions Required
Our GitHub app requires these permissions:
| Permission | Purpose | |------------|---------| | Read repository metadata | Access repo names, descriptions, visibility | | Read repository contents | Analyze code structure and complexity | | Read commit history | Calculate productivity metrics | | Read pull requests | Analyze code review patterns |
We never modify your repositories. All access is read-only.
Team Settings
After connecting, configure your team settings:
Add Team Members
Invite team members to join your workspace. They must have GitHub accounts.
Map GitHub Accounts
Link GitHub accounts to team members for accurate attribution.
Configure Exclusions
Set up exclusions for:
- Automated commits (dependabot, renovate)
- Merge commits
- Specific file patterns
Troubleshooting
No Repositories Showing
- Ensure you have at least one repository with admin/maintain access
- Try refreshing the page
- Re-authorize the GitHub app
Sync Taking Too Long
Large repositories with extensive history may take longer. You can:
- Limit sync depth in settings
- Exclude archived repositories
- Contact support for assistance
Next Steps
- Set up GitLab for additional integrations
- Configure the API for custom integrations
- Review your productivity metrics