native iOS app (hutch-based) #11

closed cmc opened this on 2026-08-24 02:55 UTC · mobile roadmap

Discussion

cmc 2026-08-24 02:55 UTC

Native iOS client for gitbay instances, built on the foundations of hutch — the architecture (Swift app driving a forge API, list/detail views for repos, issues, and reviews) carries over; the sourcehut backend layer gets replaced with gitbay's JSON API.

What the backend already provides:

  • POST /api/v1/cmd fronts the entire command registry — repos, log with signature states, issues, MRs, reviews, merges — with stable exit codes and one envelope shape (see docs/api.org)
  • bearer tokens with full or read scope and optional expiry

Things to work out:

  • onboarding: tokens are minted over SSH only (by design). The app needs a friendly path — paste a token, or scan a QR generated by gitbay token create in the terminal
  • notifications: no push story server-side yet; the hutch-notify pattern (a small relay driven by webhooks) fits, and ties into #3
  • rendering: markdown bodies, diffs, and signature badges on mobile
  • multi-instance support from day one (gitbay is self-hosted; users may have several)
cmc 2026-08-27 06:23 UTC

Development moved to krz/gitbay-ios (https://gitbay.org/krz/gitbay-ios) — future updates land there. Server-side prerequisites from this issue are done: the JSON API with GET /api/v1/read conditional reads, and the dashboard/feed/pagination reads from #40 and #41.