Skip to content

internetblacksmith/github-pr-dashboard

Repository files navigation

GitHub PR Dashboard

A Chrome/Firefox extension that replaces your new tab page with a dashboard of your GitHub pull requests. See what needs your attention at a glance — no clicking through notifications.

What it does

Every new tab shows three columns:

  • Review Requested — PRs where someone asked for your review
  • Your PRs — PRs you opened, with review status and diff stats
  • Personal Projects — All open PRs across your repos and orgs

Each PR is ranked by an attention score (0-100) based on urgency signals:

Signal Weight
Unresponded reviewer feedback +30
Pending review you haven't started +25
Stale (>24h / >48h / >72h) +5 / +10 / +15
Changes requested on your PR +10
Draft PR x0.5

A coloured severity bar on each card tells you where to look first: red (act now), orange (on your radar), grey (all clear).

When PRs span multiple orgs, a filter bar lets you toggle visibility by organisation.

Install

Three ways to install, depending on what you have:

From a release zip

Grab the latest release from the Releases page:

Chrome — download github-pr-dashboard-chrome.zip, unzip it, then:

  1. Go to chrome://extensions
  2. Enable Developer mode (top right)
  3. Click Load unpacked and select the unzipped folder

Firefox — download github-pr-dashboard-firefox-unsigned.xpi for temporary install:

  1. Go to about:debugging#/runtime/this-firefox
  2. Click Load Temporary Add-on
  3. Select the .xpi file

Note: The Firefox .xpi in releases is unsigned — it works as a temporary add-on but is removed when you close the browser. For a persistent Firefox install, use the signed version from addons.mozilla.org (when available).

From source (no build step)

Clone the repo and load it directly — no dependencies needed to just run the extension:

git clone https://github.com/internetblacksmith/github-pr-dashboard.git
cd github-pr-dashboard

Then follow the same "Load unpacked" / "Load Temporary Add-on" steps above, pointing to the cloned folder.

Build your own zip

If you want to create your own distributable zip:

git clone https://github.com/internetblacksmith/github-pr-dashboard.git
cd github-pr-dashboard
make install    # installs dev dependencies (for tests/lint only)
make build      # creates github-pr-dashboard.zip

The build excludes tests, lint config, and dev files. Load the zip the same way as a release zip.

Note: Firefox "Load Temporary Add-on" installs are removed when you close the browser. For a persistent install on Firefox, you'll need a signed build from addons.mozilla.org.

Setup

On first new tab, you'll be prompted to paste a GitHub token.

  1. Create a personal access token (link pre-fills the repo scope)
  2. Paste the token on the setup screen

Settings

Click the gear icon to configure:

  • Personal organisations — add orgs to see all their open PRs in the Personal Projects column. Drag to reorder — PRs are grouped by org in this order. Work orgs don't need to be here; your authored and review-requested PRs show up automatically. Orgs not in this list appear last, sorted alphabetically.
  • Org colours — customise badge colours for any org on the dashboard. Orgs in the personal list get their picker inline; other orgs appear in a separate section below.
  • Theme — Light, Dark, or System (follows OS preference).

Architecture

No build step, no framework, no external CDN. Vanilla HTML/CSS/JS for instant load times. The token stays in chrome.storage.local and never leaves your device. Network is restricted to api.github.com only.

Available in English, Italian, and Polish — uses the browser's language setting automatically.

See docs/architecture.md and docs/security.md for details.

Development

make install    # Install dev dependencies
make test       # Run tests (Vitest)
make lint       # Run ESLint
make build      # Create distributable zip
make ci         # All of the above
make demo       # Build demo extension for screenshots
make release    # Bump version and create PR
make tag        # Tag merged release and push

License

MIT

About

Chrome/Firefox extension that replaces the new tab page with a GitHub PR dashboard

Resources

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors