# FirstPR

> FirstPR finds open good-first issues on public GitHub repos, explains which real files an issue touches, and scores your pull request against the issue and CONTRIBUTING.md before a maintainer sees it. Free, no login, AGPL-3.0.

FirstPR is a free, open-source web app that helps developers land their first open-source pull request. Match finds open, unassigned good-first issues on public GitHub repos. Explain points to the real files an issue touches. Review scores your pull request against the issue and CONTRIBUTING.md. It never writes the fix for you.

## Features

- [Match](https://firstpr.nishal.dev/#match): Takes a GitHub username and an optional repo, then lists open good-first and help-wanted issues with no assignee.
- [Explain](https://firstpr.nishal.dev/explain): Takes a GitHub issue link and summarizes it, citing files that exist in that repo. It does not write a patch.
- [Review](https://firstpr.nishal.dev/review): Scores a pull request URL or a pasted diff against the issue, the repo's CONTRIBUTING.md, and the change itself.
- [FirstPRbot](https://firstpr.nishal.dev/#bot): A GitHub App. On a repo where it is installed, /firstpr explain on an issue posts a guide and /firstpr review on a pull request posts a score card.

## Key pages

- [Home and Match](https://firstpr.nishal.dev/): search beginner issues or match by GitHub username
- [Explain](https://firstpr.nishal.dev/explain): paste a GitHub issue link to see the files it touches
- [Review](https://firstpr.nishal.dev/review): score a pull request URL or a pasted diff
- [Issue pages](https://firstpr.nishal.dev/issue/nishal21/NekoDroid/6): /issue/{owner}/{repo}/{number} explains one issue
- [Repo pages](https://firstpr.nishal.dev/repo/nishal21/NekoDroid): /repo/{owner}/{repo} lists a repo's open beginner issues
- [Privacy](https://firstpr.nishal.dev/privacy)
- [Terms](https://firstpr.nishal.dev/terms)
- [Credits](https://firstpr.nishal.dev/credits)
- [Source code](https://github.com/nishal21/firstpr)

## About

- Made by Nishal K and Anan Shaji (NKcodex, https://nishal.dev).
- License: AGPL-3.0-or-later. A separate commercial license is available from nishal@nishal.dev.
- No login. Only public GitHub repositories are read.
- FirstPR does not write code, commit, or open pull requests for you.

## Optional

- [Full text for language models](https://firstpr.nishal.dev/llms-full.txt)