Developer Velocity
Dashboard

Analyze GitHub repositories for developer metrics with gamification. Generate beautiful dashboards with leaderboards, achievements, and team insights.

Get Started View on GitHub
Version License Go Report
terminal 
$ git-velocity analyze --config config.yaml
Fetching data from GitHub...
Processing 3 repositories...
Generated dashboard at ./dist

$ git-velocity serve --port 8080
Starting preview server at http://localhost:8080

Features

Everything you need to track developer productivity

Velocity Metrics

Track commits, PRs, reviews, and code changes over time

Gamification

Score points, earn achievements, and compete on leaderboards

Team Insights

Configure teams and see aggregated team metrics

GitHub Action

Run analysis automatically in your CI/CD pipeline

Static Site

Generate a beautiful Vue.js SPA dashboard

Fast & Cached

File-based caching and concurrent API requests

Installation

Get started in seconds

Go Install 

go install github.com/lukaszraczylo/git-velocity/cmd/git-velocity@latest

Download Binary

Download from the releases page.

Supported: macOS, Linux, Windows (amd64, arm64)

GitHub Action 

- uses: lukaszraczylo/git-velocity/.github/actions/git-velocity@main
  with:
    github_token: ${{ secrets.GITHUB_TOKEN }}
    config_file: '.git-velocity.yaml'

Usage

Simple CLI commands

CLI Commands 

# Analyze repositories and generate dashboard
git-velocity analyze --config config.yaml --output ./dist

# Start local preview server
git-velocity serve --directory ./dist --port 8080

# Show version
git-velocity version

Analyze Flags

  • -c, --config Path to config file
  • -o, --output Output directory
  • -v, --verbose Verbose output

Serve Flags

  • -d, --directory Directory to serve
  • -p, --port Port to listen on

GitHub Action Example 

name: Git Velocity Analysis

on:
  schedule:
    - cron: '0 0 * * 1'  # Weekly on Monday
  workflow_dispatch:

jobs:
  analyze:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Run Git Velocity Analysis
        uses: lukaszraczylo/git-velocity/.github/actions/git-velocity@main
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          config_file: '.git-velocity.yaml'
          output_dir: './dist'
          deploy_gh_pages: 'true'
          upload_artifact: 'true'

What Gets Tracked

Comprehensive developer activity metrics

Commits

Total commits, lines added/deleted, files changed

Pull Requests

PRs opened, merged, closed, average size

Code Reviews

Reviews given, comments, approvals, response time

Issues

Issues opened, closed, comments

Configuration

Customize everything via YAML

.git-velocity.yaml

version: "1.0"

auth:
  github_token: "${GITHUB_TOKEN}"

repositories:
  - owner: "your-org"
    name: "your-repo"

teams:
  - name: "Backend Team"
    members: ["dev1", "dev2"]
    color: "#3B82F6"

scoring:
  enabled: true
  points:
    commit: 10
    pr_opened: 25
    pr_merged: 50
    pr_reviewed: 30

output:
  directory: "./dist"
  deploy:
    gh_pages: true