GitHub Integration
FlowDeck integrates with GitHub so you can track branches, pull requests, and commit history directly alongside your tasks.
Linking a Repository to a Molecule
Repositories are linked at the molecule (project) level. To connect a GitHub repository:
- Open the molecule in FlowDeck.
- Click the Settings tab within the molecule view.
- Under the GitHub section, click Link Repository.
- Select the repository from the list of repositories connected to your organization, or paste in the repository URL.
- Click Save.
To connect GitHub repositories to your organization in the first place, go to your Organization Settings and navigate to the Repositories section.
Branch Tracking Per Task
Once a molecule is linked to a repository, each atom (task) can have a dedicated GitHub branch. In the task detail view, you will see a Branch field. You can:
- Type a branch name to link an existing branch.
- Click Create Branch to generate a new branch directly from the task.
The branch status (ahead, behind, merged) is shown in real time within the task.
Pull Request Tracking
If a pull request is opened against the linked branch, FlowDeck detects it automatically and displays the PR title, status, and a link in the task detail view. You can see at a glance whether the PR is open, under review, or merged without leaving FlowDeck.
Commit History
The task detail view includes a Commits tab showing all commits made to the linked branch. Each entry shows the commit message, author, and timestamp.
Webhook Setup
Automatic updates — such as PR status changes and new commits — are powered by a GitHub webhook. When you link a repository, FlowDeck provides the webhook URL to configure in your GitHub repository settings under Settings → Webhooks. Once the webhook is active, FlowDeck updates task data in real time as events occur.
For an overview of task fields, see Atoms — Tasks.