GitDash — GitHub Actions Dashboard

GitDash Docs

Introduction

📊

Engineering Intelligence

Deep-dive into DORA metrics, Cycle Time breakdowns, and success rates across all your GitHub Actions workflows and Pull Requests.

💰

Cost Analytics

Track GitHub Actions minutes and spend per workflow. Identify runaway costs and optimize your CI budget.

🔒

Enterprise Security

Your PAT never touches the browser. AES-256-GCM encrypted sessions, HttpOnly cookies, and rate limiting built-in.

👥

Team Performance

Reviewer load balancing, CI success rates per contributor, and upcoming deep-dive Contributor Profiles to prevent burnout.

Prerequisites

Node.js 20+
npm (or Docker for containerized deployments)
A GitHub Personal Access Token — for standalone mode
A GitHub OAuth App — for organization mode (team sharing)

Quick Start — Standalone Mode

The fastest way to get running. No OAuth App needed — just your GitHub PAT.

terminal

git clone https://github.com/dinhdobathi1992/gitdash.git
cd gitdash
cp .env.local.example .env.local

# Edit .env.local — set these two values:
MODE=standalone
SESSION_SECRET=$(openssl rand -hex 32)

npm install
npm run dev

Open http://localhost:3000 — you will be redirected to /setup to enter your PAT.

Quick Start — Organization Mode

For teams sharing a single deployment. Requires a GitHub OAuth App.

Create a GitHub OAuth App

Go to GitHub → Settings → Developer settings → OAuth Apps → New OAuth App. Set the callback URL to http://localhost:3000/api/auth/callback.

Configure .env.local

.env.local

MODE=organization
GITHUB_CLIENT_ID=your_client_id
GITHUB_CLIENT_SECRET=your_client_secret
SESSION_SECRET=$(openssl rand -hex 32)

Start the server

terminal

npm install && npm run dev

Generate a strong SESSION_SECRET with: openssl rand -hex 32

Required GitHub PAT Scopes

Scope	Purpose
`repo`	Repository list + workflow data (private repos)
`workflow`	Workflow runs and job details
`read:org`	Organization membership + org repo list
`read:user`	User identity (avatar, name, login)

For reduced permissions, use a fine-grained PAT with Actions: read and Contents: read scoped to specific repos.

git clone https://github.com/dinhdobathi1992/gitdash.git cd gitdash cp .env.local.example .env.local # Edit .env.local — set these two values: MODE=standalone SESSION_SECRET=$(openssl rand -hex 32) npm install npm run dev

Scope

Purpose

repo

Repository list + workflow data (private repos)

workflow

Workflow runs and job details

read:org

Organization membership + org repo list

read:user

User identity (avatar, name, login)