The GitHub integration brings your issues and reviews into Flots. A repository linked to a project turns its issues into tasks there, which the whole team can follow without opening GitHub. It's included in the Pro and Team plans.
Connect your GitHub account
- Open Settings › GitHub and click Connect GitHub.
- GitHub opens and offers to install the Flots app. Pick the accounts and repositories Flots can reach.
- Come back to Flots: the connection updates on its own and shows GitHub is connected.
To add or remove a repository later, use Manage accounts and repositories. From the mobile app, the connection goes through your phone's browser, then brings you back to Flots.
Link a repository to a project
That link is what turns issues into tasks.
- In Settings › GitHub, in the Repositories and projects block, pick the project each repository feeds.
- Or, from the project: open its settings, under Linked GitHub repositories.
A repository feeds one project only. In that repository, the issues assigned to you or opened by you, and the pull requests you're asked to review, become tasks of the project. The task takes the title, links back to GitHub, and a checklist written in the issue comes across as sub-tasks.
Keep up with your issues and reviews
In your planner, the GitHub block has two tabs, Issues and Pull requests: what's assigned to you, the reviews you've been asked for, and CI status. Click a pull request to list its checks, failures first.
When an issue is closed or a pull request merged, the task shows up under Finished on GitHub. Complete closes it, Finish all closes them all. Flots doesn't do it for you: a merge doesn't always mean the planned work is done.
Choose what notifies you
For each repository linked to a project, you pick the notifications: New issue, Issue resolved, New pull request, CI failed. These settings live in Settings › GitHub and in the project's settings, kept in sync. Only the person who connected GitHub receives them.
What the rest of the team sees
Development tasks are project tasks like any other. The project manager or the sales lead see their status and sub-tasks alongside the rest of the work, with no GitHub account.
For a whole team, the Set up Flots for a startup path shows where GitHub fits.
Disconnect GitHub
In Settings › GitHub, Disconnect cuts off access. Tasks already created stay. The app stays installed on the GitHub side: to remove it completely, go through Manage accounts and repositories.