PR Tracker Docs
Sign inSign up

Getting started

From sign-up to first PR event in under five minutes.

1. Create an account

Sign up at /signup with email and password.

2. Create your workspace

Pick a name and a URL slug (e.g. acme-team). Your dashboard lives at /<slug>. Set your timezone — daily reports use it for the 5 PM day boundary.

3. Connect Slack

Open Settings → Slack integration. Two options:

  • OAuth (one-click): click "Install / re-install via Slack" — requires the server to have SLACK_CLIENT_ID, SLACK_CLIENT_SECRET, and SLACK_GLOBAL_SIGNING_SECRET env vars.
  • Manual: paste your xoxb- Bot Token + Signing Secret. The form tests the credentials and saves them encrypted.

See Slack setup for the full Slack App configuration.

4. Send a test message

In any Slack channel where your bot is added, post:

WEB-1142 https://github.com/your-org/your-repo/pull/1

Open the Today page in PR Tracker — you should see a new "PR Opened" KPI and a row in the developer table.

5. Reply with approval / merge / deploy

The bot picks up follow-up signals in the same channel or thread:

approved lgtm +1 merged deployed on PROD

Next steps