kaneo icon indicating copy to clipboard operation
kaneo copied to clipboard

feat: Gitea Support

Open nerdware-timmmi opened this issue 4 months ago • 3 comments

Problem Statement

Hey there! I'd love to have better integration between Kaneo and my self-hosted Git setup. Right now, I'm running my own Gitea instance because I prefer keeping my code repositories under my own control, but I'm missing out on the nice issue sync features that other tools have with GitHub (like right kaneo). It would be awesome if I could connect my Kaneo projects directly to my Gitea repositories to keep everything in sync.

Proposed Solution

It would be fantastic if we could add Gitea integration alongside the existing GitHub support! The idea would be to:

  • Let users configure their own Gitea server URL in the settings
  • Add a simple way to store Gitea credentials (username and personal access token)
  • Use the Gitea API to pull issues into Kaneo projects
  • Keep issues synchronized between both platforms
  • The Gitea API is pretty straightforward and well-documented, so it shouldn't be too different from the GitHub implementation.

Alternative Solutions

I've thought about a few workarounds:

  • Setting up some kind of webhook bridge (but that's adding complexity)
  • Manually copying issues back and forth (definitely not fun)
  • Using GitHub as a mirror (but that defeats the whole self-hosting purpose)
  • Building a separate sync tool (seems like overkill)

None of these feel as clean as having native support built right into Kaneo.

Relevant Context

The Gitea API docs are pretty good: https://docs.gitea.com/api/1.20/#tag/issue/operation/issueSearchIssues

This would be especially great for folks in the open-source community who are already self-hosting everything else. Plus, Gitea is becoming really popular as a lightweight alternative to GitLab and GitHub, so I think other users would appreciate this too! Plus, there are also a few forks that may work similarly and are therefore supported as well. (Codeberg, Forgejo)

Does this feature align with Kaneo's focus on simplicity?

Absolutely! This fits perfectly with Kaneo's philosophy because:

  • It supports the "your data stays yours" principle that Kaneo already embraces
  • It wouldn't complicate the UI - just add Gitea as another option alongside GitHub
  • It keeps everything in one place, which is exactly what makes Kaneo great
  • It's optional, so users who don't need it won't be bothered by it
  • It makes the self-hosted experience even better

This feels like a natural extension of what makes Kaneo special - being open source, fast, and respecting user choice about where their data lives.

nerdware-timmmi avatar Aug 04 '25 21:08 nerdware-timmmi

🎯 Task created - feat: Gitea Support

Task Details
  • Task ID: kaignz5ffbdhjn3ymehczh74
  • Priority: medium
  • Status: to-do

This issue is automatically synchronized with your Kaneo project.

usekaneo[bot] avatar Aug 04 '25 21:08 usekaneo[bot]

I'm on it.

nerdware-timmmi avatar Aug 06 '25 17:08 nerdware-timmmi

Awesome, could this make forgejo support easier?

parasiteoflife avatar Aug 24 '25 05:08 parasiteoflife