Docs/Integrations/GitHub

GitHub

Create GitHub issues from feedback and add codebase context to PRDs

The GitHub integration turns feedback submissions into GitHub Issues automatically — with the full PRD as the issue body, priority and category applied as labels, and status kept in sync both ways. Connecting GitHub also gives Flowback's AI context about your codebase, so the PRDs it writes are more specific and actionable.

Connecting GitHub

  1. Navigate to Integrations in your dashboard
  2. Click Connect GitHub
  3. Authorize Flowback on GitHub when prompted
  4. Select the repository you want to use

You can route different channels to different repositories from each channel's settings.

What gets created

When a submission is created (or approved in Split & Review mode), Flowback opens a GitHub Issue with:

  • Title — The issue title, with a reference number for cross-linking
  • Body — The full PRD, including problem statement, user impact, acceptance criteria, and links to any uploaded screenshots
  • Labels — The AI-assigned priority and the channel's category, applied as labels

Two-way status sync

Once an issue is linked, it stays in sync in both directions:

  • Changing an issue's status or priority in Flowback updates its labels in GitHub
  • Changing the priority or status labels in GitHub updates the matching issue in Flowback
  • Comments on a linked issue are mirrored between GitHub and the Flowback portal thread

Codebase context for PRDs

Alongside issue creation, Flowback uses your connected repository to write better PRDs. It references your project's structure and recent history to point engineers at the relevant parts of the codebase:

  • Relevant files — The AI suggests which files are likely related to the feedback
  • Recent changes — If a bug may relate to a recent change, the PRD notes it
  • Technical context — PRDs can reference your tech stack and project structure
Note
Flowback does not store your source code. It uses repository metadata — file paths, README content, and commit summaries — to add context to PRDs, and this is refreshed periodically.

Disconnecting

You can disconnect GitHub at any time from the Integrations page. Disconnecting:

  • Stops new issues from being created and ends two-way sync
  • Does not delete any existing GitHub Issues
  • Does not delete any submissions in Flowback
  • Removes the stored access token and codebase context

You can reconnect at any time.