How to use ReviewRadar

Learn how to monitor, organize, and manage your GitHub pull requests with ReviewRadar.

Contents

📚 Getting Started 🔐 Creating a GitHub Token 📊 Dashboard Overview 📁 Managing Repositories ⚡ Auto-Refresh Configuration 🔒 Data Storage & Privacy 🎨 Appearance & Theme 💡 Tips & Tricks 🔧 Troubleshooting

📚 Getting Started

ReviewRadar helps you monitor all your pull requests in one place. Follow these steps to get started:

  1. Create a GitHub Personal Access Token (PAT) with repo scope
  2. Enter your PAT on the dashboard
  3. Click "Sweep now" to load your pull requests
  4. Configure auto-refresh and repositories in Settings

🔐 Creating a GitHub Token

You need a GitHub Personal Access Token to authenticate with the GitHub API. Here's how to create one:

  1. Go to github.com/settings/tokens/new
  2. Give your token a descriptive name (e.g., "ReviewRadar")
  3. Under "Scopes", select repo (full control of private repositories)
  4. Click "Generate token" at the bottom
  5. Copy the token immediately — you won't be able to see it again
  6. Paste the token in ReviewRadar's dashboard or Settings page

📊 Dashboard Overview

Repository Selector

Dropdown to view PRs from specific repositories or all repos. Auto-discovered when you load PRs.

PR Table

7-column view showing: Author, PR Title, Status, Review Count, Requested Reviewers, Time since update, and Actions. Sort by any column.

Stat Cards

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

Status Badges

Green (approved), yellow (changes requested), blue (in review), gray (awaiting review).

📁 Managing Repositories

ReviewRadar can track PRs from multiple repositories. Here's how to manage them:

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 in owner/repo-name format.

Example: github/cli

Selecting Repositories

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

⚡ Auto-Refresh Configuration

Keep your PR dashboard up-to-date automatically:

Enabling Auto-Refresh

Go to Settings → Refresh & Notifications and toggle "Auto-refresh PRs" on. Dashboard will refresh at the configured interval.

Setting Refresh Interval

Choose an interval from 1-60 minutes. Default is 5 minutes. Lower intervals mean more frequent API requests.

Browser Notifications

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

🔒 Data Storage & Privacy

ReviewRadar stores all data locally in your browser:

  • GitHub PAT: Stored in browser localStorage, never sent to external servers
  • PR Data: Cached locally for offline viewing
  • Settings: Theme, auto-refresh, and notification preferences stored locally
  • Clearing Data: Go to Settings → Data Management to clear any stored data

🎨 Appearance & Theme

ReviewRadar supports both dark and light modes:

Switching Themes

Go to Settings → Appearance and select your preferred theme. The choice is saved automatically.

System Theme

The dashboard defaults to dark mode. You can toggle light mode from the top navigation or Settings.

💡 Tips & Tricks

  • Sort PRs: Click any column header to sort by that field
  • Filter by Status: Use filter pills below the toolbar to view specific PR statuses
  • Quick Access: Use keyboard shortcut or browser tab to quickly check for PR updates
  • Reports Page: View historical trends and metrics across all repositories
  • Multiple Repos: Configure several repositories to monitor your entire team's work
  • Notifications: Enable browser notifications to stay alert without constantly checking the dashboard

🔧 Troubleshooting

PAT Not Working?

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

No PRs Showing?

Try clicking "Sweep now" to force a refresh. Make sure you have PRs assigned to you or repos added to the watch list.

Data Lost?

Browser data is cleared when you clear browser storage. Your GitHub PAT is only stored locally and can be re-entered in Settings anytime.

Still Having Issues?

Check your browser's Developer Console (F12) for error messages. Make sure your GitHub account has access to the repositories you're trying to monitor.

© 2026 ReviewRadar · GitHub PR Dashboard