How kunaaaalcodes/nextpr works
NextPR discovers open GitHub issues, enriches them with repository activity, and ranks them against a developer profile for browsing and recommendations. The graph includes OAuth/profile management, saved issues, and the principal crawl-to-ranked-feed workflow. Several frontend-to-API connections are not shown in the sampled source, so those links are marked unverified rather than asserted.
Main entry points: me.ts Profile and saved routes · issues.ts Issue routes · crawler.ts Issue crawler · auth.ts GitHub OAuth routes
Components 21
Web application
- Browse and dashboard
apps/web/src/app - Saved issues page
apps/web/src/app/saved/page.tsx - Auth callback page
apps/web/src/app/auth/callback/page.tsx - Web API client
apps/web/src/lib/api.ts - Web auth state
apps/web/src/lib/auth.tsx
Identity and profiles
- GitHub OAuth routes
apps/api/src/routes/auth.ts - Profile analysis
apps/api/src/services/profile.ts - User model
apps/api/src/models/User.ts - API authentication
apps/api/src/middleware/auth.ts - Profile and saved routes
apps/api/src/routes/me.ts
Issue discovery
- Issue crawler
apps/api/src/services/crawler.ts - Ranking engine
apps/api/src/services/scoring.ts - Issue routes
apps/api/src/routes/issues.ts
Persistence
- Issue model
apps/api/src/models/Issue.ts - Repository model
apps/api/src/models/Repo.ts - MongoDB connection
apps/api/src/db.ts - API configuration
apps/api/src/config.ts - API server
apps/api/src/index.ts
Other components
- Developer
- GitHub API
apps/api/src/services/github.ts - MongoDB
Connections 37
- Developer → Browse and dashboard: browses recommendations
README.md - Developer → Saved issues page: revisits saved issues
README.md - Developer → Auth callback page: signs in
README.md - Browse and dashboard → Web API client: requests data
- Saved issues page → Web API client: loads saved issues
- Auth callback page → Web auth state: stores session
- Web auth state → Web API client: uses
apps/web/src/lib/auth.tsx - Web API client → Issue routes: calls API
- Web API client → Profile and saved routes: calls API
- GitHub OAuth routes → GitHub API: exchanges code
apps/api/src/routes/auth.ts - GitHub OAuth routes → GitHub API: fetches account
apps/api/src/routes/auth.ts - GitHub OAuth routes → Profile analysis: analyzes profile
apps/api/src/routes/auth.ts - GitHub OAuth routes → User model: saves account
apps/api/src/routes/auth.ts - Profile and saved routes → API authentication: requires authentication
apps/api/src/routes/me.ts - Profile and saved routes → User model: reads and updates
apps/api/src/routes/me.ts - Profile and saved routes → GitHub API: refreshes profile
apps/api/src/routes/me.ts - Profile and saved routes → Profile analysis: reanalyzes profile
apps/api/src/routes/me.ts - Profile and saved routes → Issue model: loads saved issues
apps/api/src/routes/me.ts - Profile and saved routes → Repository model: loads repository details
apps/api/src/routes/me.ts - Issue routes → API authentication: guards matches
apps/api/src/routes/issues.ts - Issue routes → Issue model: queries issues
apps/api/src/routes/issues.ts - Issue routes → Repository model: loads repository data
apps/api/src/routes/issues.ts - Issue routes → User model: loads profile
apps/api/src/routes/issues.ts - Issue routes → Ranking engine: ranks candidates
apps/api/src/routes/issues.ts - Issue routes → Issue crawler: starts crawl
apps/api/src/routes/issues.ts - Issue crawler → GitHub API: fetches issues and repos
apps/api/src/services/crawler.ts - Issue crawler → Repository model: upserts repository data
apps/api/src/services/crawler.ts - Issue crawler → Issue model: upserts issues
apps/api/src/services/crawler.ts - Issue crawler → Ranking engine: infers difficulty
apps/api/src/services/crawler.ts - API server → MongoDB connection: connects database
apps/api/src/index.ts - API server → GitHub OAuth routes: mounts routes
apps/api/src/index.ts - API server → Issue routes: mounts routes
apps/api/src/index.ts - API server → Profile and saved routes: mounts routes
apps/api/src/index.ts - MongoDB connection → API configuration: reads settings
apps/api/src/db.ts - Issue model → MongoDB: persists documents
apps/api/src/models/Issue.ts - Repository model → MongoDB: persists documents
apps/api/src/models/Repo.ts - User model → MongoDB: persists documents
apps/api/src/models/User.ts