Pull Requests Board

A board to view and filter open GitHub pull requests for an organization. Supports author/tag filters, priority, sort, and optional auth with saved settings.

Prerequisites

• Node.js 18+
• PostgreSQL
• GitHub Personal Access Token (repo scope)

Setup

1. Clone and install

   npm install

2. Environment

   Copy .env.example to .env and set:

   • GITHUB_ORG – GitHub organization name
   • DEFAULT_REPO – Default repo when none is selected
   • GITHUB_TOKEN – GitHub PAT (repo scope); see GitHub token below
   • DATABASE_URL – PostgreSQL connection string
   • NEXTAUTH_URL – App URL (e.g. http://localhost:3000)
   • NEXTAUTH_SECRET – Random secret for sessions

3. Database

   npx prisma migrate deploy
   npx prisma generate

4. Run

   npm run dev

Open http://localhost:3000.

GitHub token

1. On GitHub: Profile (avatar) → Settings → Developer settings → Personal access tokens (or go to github.com/settings/tokens).
2. Generate new token → Generate new token (classic).
3. Name it (e.g. pull-requests-board), set an expiration, and enable the repo scope.
4. Generate token, copy it once (it won’t be shown again), and set it as GITHUB_TOKEN in .env.

Scripts

• npm run dev – Development server
• npm run build – Production build
• npm run start – Run production build
• npm run lint – Lint