Guide

Learn how to use ReviewRadar

Documentation

How to use ReviewRadar

Learn how to monitor, organize, and manage your GitHub pull requests with ReviewRadar. Get started in minutes.

Getting Started

Step 1: Create a GitHub Token
  1. Go to github.com/settings/tokens/new
  2. Give your token a descriptive name (e.g., "ReviewRadar")
  3. Under "Scopes", select repo scope
  4. Click "Generate token"
  5. Copy the token immediately — you won't be able to see it again
  6. Paste the token in ReviewRadar's Settings page
Step 2: Access ReviewRadar

Paste your token on the Settings page, then head to the Dashboard to load your pull requests. Click "Sweep now" to fetch all your PRs.

Dashboard Overview

Repository Selector

Dropdown menu to view PRs from specific repositories or all repos. Repositories are auto-discovered when you sweep, or you can add them manually in Settings.

PR Table

9-column view showing Pull Request, Author, Status, My Action, Approvals, Comments, Labels, Build, and Updated time. Click any column header to sort. Click a label or status badge in any row to instantly filter the table by that value.

Stat Cards

Quick overview of total PRs, awaiting review, approved, and changes requested counts.

Status Badges

Visual indicators: Green (approved), Orange (changes requested), Cyan (in review), Gray (awaiting review). Click any badge to filter the table by that status.

Click-to-Filter

Click any label or status badge in the PR table to filter by that value. An active filter pill appears in the filter bar — click the × to remove it. Only one field filter is active at a time, and it stacks with the stat cards (Total PRs / Mine / Needs Attention / Approved / Blocked).

Managing Repositories

Auto-Discovery

When you run "Sweep now", ReviewRadar automatically discovers all repositories from your assigned PRs and saves them.

Manual Addition

Go to Settings → Saved Repositories and add repos manually. Format: owner/repo-name

Selecting Repositories

Use the repository dropdown on the dashboard to filter PRs by specific repos or view all at once.

Auto-Refresh & Notifications

Enabling Auto-Refresh

Go to Settings → Refresh & Notifications and toggle "Auto-refresh PRs". The dashboard will refresh at your configured interval.

Setting Interval

Choose an interval from 1-60 minutes (default is 5 minutes). Lower intervals mean more frequent API requests and faster updates.

Browser Notifications

Enable notifications to receive browser alerts when PRs are approved or changes are requested.

Theme & Appearance

Dark & Light Mode

ReviewRadar supports both dark and light modes. Go to Settings → Appearance to switch themes. Your choice is saved automatically.

Default Theme

ReviewRadar defaults to dark mode for a comfortable viewing experience. Light mode is available for those who prefer it.

Data Storage & Privacy

Local Storage Only

ReviewRadar stores all data locally in your browser. Your GitHub PAT, cached PRs, and preferences are never sent to external servers.

What Gets Stored
  • GitHub PAT: Stored locally, never shared
  • PR Data: Cached for offline viewing
  • Settings: Theme, auto-refresh, notification preferences
  • Repositories: List of configured repos
Clear Data

Go to Settings → Data Management to clear cached PR data, saved repos, or all data at once.

Tips & Tricks

  • Sort PRs: Click any column header to sort by that field
  • Click-to-Filter: Click any label or status badge in the table to filter by that value
  • Filter by Status: Use status pills below the toolbar to view specific PR states
  • Multiple Repos: Monitor several repositories to track your entire team's work
  • Reports Page: View trends and metrics across all repositories
  • Auto-Refresh: Leave the dashboard open and let it update automatically
  • Browser Notifications: Stay alert without constantly checking the dashboard

Troubleshooting

PAT Not Working?

Make sure your token has the repo scope selected. Tokens expire after one year — create a new one if yours has expired.

No PRs Showing?

Try clicking "Sweep now" to force a refresh. Make sure you have PRs assigned to you, or add repositories to your watch list in Settings.

Data Lost After Refresh?

Clearing your browser storage will remove cached data. Your GitHub PAT is only stored locally and can be re-entered anytime.

Still Having Issues?

Check your browser's Developer Console (F12) for error messages. Ensure your GitHub account has access to the repositories you're monitoring.

© 2026 ReviewRadar · GitHub PR Dashboard