Documentation v1.0
Docs GitHub Integration PR Badges & Activity

PR Badges & Activity

When you use GitHub's branch naming convention (story-{id}-description), SprintVibe automatically links pull requests to stories and surfaces PR data across the app.

PR badges on Kanban cards

Stories with linked pull requests show a small badge in the card footer with a git icon and PR count. The badge color indicates the overall PR state:

  • Green — At least one PR is open
  • Purple — At least one PR has been merged
  • Muted — All PRs are closed (not merged)

Hover over the badge to see a tooltip with each PR number and its state.

PR badges on Planning view

The sprint planning view shows the same PR badge inline next to each story title, so you can see development progress while reviewing and organizing your sprint.

GitHub events in the activity feed

When a PR is opened or merged for a story, SprintVibe automatically creates an activity entry in the story's activity feed. These system events are visually distinct from user comments:

  • Displayed with a GitHub icon instead of a user avatar
  • Shown with muted, italic styling
  • Labeled as "GitHub" in the author field
  • Cannot be edited or deleted (they're system-generated)

Example messages: - "PR #42 opened — story moved to Review" - "PR #42 merged — story moved to Done"

PR review status

SprintVibe tracks PR review status from GitHub webhooks. When a reviewer approves or requests changes on a PR, the review status is updated automatically.

Review status badges appear next to the PR state badge on open PRs in the story sidebar:

  • Pending Review (gray) — No reviews submitted yet
  • Changes Requested (yellow) — A reviewer has requested changes
  • Approved (green) — The PR has been approved

Review status updates also log activity entries and notify the story assignee.

PR notifications

Story assignees receive in-app notifications when:

  • A PR is opened for one of their stories
  • A PR is merged for one of their stories
  • A PR review is submitted for one of their stories

PR notifications follow your existing notification preferences — if you have assignment notifications enabled, you'll also receive PR notifications. Manage this from SettingsNotifications.

Last updated July 18, 2026