Welcome to DevStats. This guide walks you through everything you need to get your first insights up and running: from creating your squad to exploring your dashboards.
✅ Prerequisites
Before you begin, make sure you have:
- An account with a supported Git provider: GitHub, GitLab, GitLab Self-Managed, Bitbucket, Bitbucket Data Center, or Azure Repos.
- Access to a repository with some development activity: the more history available, the richer your dashboards will be.
- Permissions to authenticate DevStats with your chosen platforms.
Step 1: Sign Up
Create your DevStats account by visiting the DevStats homepage and clicking Sign Up. Follow the prompts to register and verify your account.
Step 2: Create Your First Squad
A Squad is the core unit in DevStats. It represents your development team (or a subset of it) and defines which developers and repositories are tracked.
To create a squad:
- Go to the Squads tab in your dashboard.
- Click Add First Squad.
- Fill in the squad details:
- Name: a clear, descriptive name for the team.
- Manager: assign a manager (you can select yourself).
- Logo: optional. Upload a picture for your squad.
- Click Save.
Step 3: Connect Your Data Sources
Once your squad is created, it's time to bring in data. DevStats supports three types of integrations — connect as many as apply to your team for the most complete picture.
🔗 Git Provider (Required)
Connect your source code platform so DevStats can track pull requests, commits, cycle time, and deployment activity.
| Provider | Docs |
|---|---|
| GitHub | View guide |
| GitLab | View guide |
| GitLab Self-Managed | View guide |
| Bitbucket | View guide |
| Bitbucket Data Center | View guide |
| Azure Repos | View guide |
The screenshots below show a general example of the connection flow. For detailed, provider-specific instructions, refer to the individual guide linked in the table above.
1. From the squad overview, open the Integrations tab and click Add Integration.
2. Select your Git provider and click to authenticate.
3. Log in and authorize DevStats access.
4. Grant DevStats access to your account/organization.
5. Select the repositories you want to track and click Save Integration.
After connecting, DevStats will begin importing your historical data. This may take a few minutes to a few days, depending on repository size. You will receive an email once your dashboards are ready.
📋 Issue Tracker (Recommended)
Connecting an issue tracker allows DevStats to read ticket labels, issue states, and cycle time data, significantly improving the accuracy of your metrics.
| Tracker | Docs |
|---|---|
| Jira Cloud | View guide |
| Jira Data Center | View guide |
| Linear | View guide |
| Azure Boards | View guide |
| GitHub Projects | View guide |
| ClickUp | View guide |
From the squad overview, open the Integrations tab, click Add Integration, select your issue tracker, and follow the authentication steps. For provider-specific instructions, refer to the individual guide linked in the table above.
🤖 AI Tools (Optional)
Connect your AI coding tools to track usage and measure their impact on your team's productivity.
| Tool | Docs |
|---|---|
| GitHub Copilot | View guide |
| Claude | View guide |
Step 4: Explore Your Dashboards
Once data starts flowing in, your dashboards will populate automatically. Here are the key areas to start with:
- PR Cycle Time: Understand how quickly your pull requests move from creation to deployment.
- Deploy Frequency: Measure how often your team deploys code.
- Issue Cycle Time: Track how efficiently your team resolves tasks.