Skip to content

[Feature Request]: GitHub-backed Kanban issues for AFFiNE databases (Linear-style sync) #14757

@ibex088

Description

@ibex088

Description

I’d love AFFiNE’s Kanban/database tickets to support a native GitHub Issues integration, similar to Linear’s GitHub sync workflow.

The main idea is that a Kanban board, database, or selected view in AFFiNE can be connected to a GitHub repository so tickets and GitHub issues stay in sync.

What I’d like this to support:

  • Connect an AFFiNE Kanban board or database to a GitHub repository.
  • Creating a new card in AFFiNE creates a new GitHub issue automatically.
  • Optionally support the reverse flow too, where a new GitHub issue creates a synced AFFiNE card.
  • Sync title and description/body between AFFiNE and GitHub.
  • Sync labels between AFFiNE properties and GitHub labels.
  • Sync owner/assignee between AFFiNE and GitHub assignees.
  • Allow commenting directly from the AFFiNE card and sync those comments to GitHub.
  • Reflect GitHub comments back into AFFiNE.
  • Support attachments/images/files added in AFFiNE so they are uploaded or linked correctly in GitHub.
  • Show the linked GitHub issue clearly inside the AFFiNE card, including sync state or sync errors.
  • Add notifications in AFFiNE when there is a new comment or update on the linked GitHub issue.

One important detail is user mapping. A good approach would be:

  • Each AFFiNE user connects their own GitHub account in personal settings.
  • Synced comments, assignments, and activity are then mapped to the correct GitHub user.
  • If a user has not connected GitHub yet, AFFiNE could use an admin-defined fallback mapping or simply disable assignment sync for that user.

Use case

This would make AFFiNE much more useful for software teams and open-source workflows.

  • Teams could plan work in AFFiNE while keeping GitHub as the external source of collaboration.
  • Open-source maintainers could triage GitHub issues from an AFFiNE Kanban board.
  • Product and engineering teams could manage labels, owners, comments, and updates without switching constantly between tools.
  • It would make AFFiNE feel much closer to Linear for engineering project management.

Anything else?

Features from Linear that feel especially relevant here:

  • Repo-to-board linking.

  • One-way or two-way issue sync.

  • Label sync.

  • Assignee sync through connected personal GitHub accounts.

  • Comment sync through a dedicated synced thread.

  • Notifications for new GitHub comments.

  • Future enhancements could include PR linking and workflow/status automation based on GitHub activity.
    A good MVP could be:

  • Connect one AFFiNE board/database to one GitHub repo.

  • Create GitHub issues from new AFFiNE cards.

  • Sync title, description, labels, assignee, and comments.

  • Show a GitHub badge/link on the AFFiNE card.

  • Notify AFFiNE users when a synced GitHub issue receives a new comment.

Are you willing to submit a PR?

  • Yes I'd like to help by submitting a PR!

Is your content generated by AI?

  • I confirm that the content I submitted was not generated by AI / merely contained minimal AI edits.

Metadata

Metadata

Assignees

No one assigned

    Labels

    storyFeatures perceivable by end-users

    Type

    No type

    Projects

    Status

    🆕 *Untriaged

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions