#+title: gitbay-ios #+author: Christian Cleberg A native iOS client for [[https://gitbay.org][gitbay]], a CLI-first git forge. This app is a reading, reviewing and responding surface for the times you are not at a keyboard. [[https://apps.apple.com/us/app/gitbay/id6806399095][Download on the App Store]] * What it does | Area | What's there | |---------------------------+------------------------------------------------------------------------------------------------------------------------------------| | Dashboard | Your review queue, assigned work, open merge requests and issues, pinned saved queries, pinned repositories, recent activity, and the unread count | | Repositories | File tree and blob view with syntax highlighting and names linked to their definitions, history at a ref or per file, blame, branches and tags, file editing on a branch, a compare between any two refs, and finding a definition from the symbol index | | Merge requests | Lists and detail with a unified diff, comments and review threads started from a diff line, suggested changes and applying them, reactions, review verdicts and requests, draft and ready, retarget, milestones, merge when ready, and the stack a merge request sits in | | Issues | Lists and detail, comments, reactions, labels with the colours the web paints them, assignees and milestones, filtering by label, assignee, author and milestone | | Search | Title-and-body search within a repository, file contents across one repository, the whole instance for repositories, issues and merge requests, and saved queries across repositories | | Notifications | The inbox, unread or all, marked read singly or in bulk. Push registers this device against every signed-in account; a tap opens the issue, merge request or build it names | | Repository actions | Fork, bookmark, watch and mute, pin, archive, visibility, topics, branch protection, required checks, dependency checks with their status, rename, transfer and delete | | Builds | Build list, job picker, logs whole or their last lines, and cancelling one that is queued or running | | Releases and wiki | Releases list, detail, create with notes summarized from merged merge requests, edit and delete. Wikis read from the same instance | | Organisations | Members and roles, teams and their repository grants, create and rename | | Your account | SSH keys with their last use and expiry, PGP keys, email addresses, API tokens, notification settings including reply by mail, your profile — description, website, about text and links — and deleting the account | | Explore, feed and profiles | Discovery, activity, contribution graph | | Administration | For instance admins: worker queues, accounts with their detail, limits, roles and state, creating, deleting and inviting, repositories with archive, visibility, reindex and delete, organization limits, statistics, the audit log, runners and the reply mailbox | | Markup | Bodies and comments are written and rendered in the format they were stored in. Org renders natively through [[https://gitbay.org/krz/org-swift][OrgSwiftUI]] — selectable text, Dynamic Type, VoiceOver — rather than in a web view. TeX math in either format is typeset with [[https://github.com/mgriebling/SwiftMath][SwiftMath]] by the web's rules | Everything in your account the CLI can do reaches the app. * Signing in To sign in to the mobile app you need a bearer token. Create one with full scope under Settings → API tokens on the instance's website (=https:///settings#tokens=), or over SSH: #+begin_src sh gitbay auth token create --name iphone --scope full --ttl 90d #+end_src Full scope can comment and merge, and on an admin account, administer the instance. =--scope read= works too, but a read-only token cannot comment or merge. Any gitbay instance works. You just need to enter the host at sign-in. * Building Builds with the iOS 26.5 SDK and runs on iOS 18.0 and later. Swift 6 language mode, default =MainActor= isolation. #+begin_src sh xcodebuild -project gitbay.xcodeproj -scheme gitbay \ -destination 'platform=iOS Simulator,name=iPhone 17' build #+end_src Dependencies resolve over SSH ([[https://gitbay.org/krz/org-swift][krz/org-swift]]) and HTTPS ([[https://github.com/raspu/Highlightr][Highlightr]], [[https://github.com/mgriebling/SwiftMath][SwiftMath]]), so a key that can reach gitbay.org is needed to build. * Tests =gitbayTests= is hermetic and runs offline; network calls go through a stubbed =URLProtocol=. #+begin_src sh xcodebuild -project gitbay.xcodeproj -scheme gitbay \ -destination 'platform=iOS Simulator,name=iPhone 17' \ test -only-testing:gitbayTests #+end_src =gitbayUITests= includes a live smoke suite that talks to a real instance. It is opt-in, and skips without both variables. Environment reaches the test runner only with the =TEST_RUNNER_= prefix: #+begin_src sh TEST_RUNNER_GITBAY_UITEST_LIVE=1 \ TEST_RUNNER_GITBAY_UITEST_TOKEN= \ xcodebuild -project gitbay.xcodeproj -scheme gitbay \ -destination 'platform=iOS Simulator,name=iPhone 17' test #+end_src The suite runs as the =ios-smoke= account, not a personal one: it owns the scratch and fixture repositories and is an admin of =krz=. An instance admin provisions it once with =gitbayUITests/smoke-account.sh=, which also writes the account's SSH key to =~/.ssh/gitbay-ios-smoke=. The token above is minted with that key: #+begin_src sh ssh -F /dev/null -i ~/.ssh/gitbay-ios-smoke -o IdentitiesOnly=yes \ git@gitbay.org token create --name ui-smoke --scope full --ttl 30d #+end_src Setup signs in only when it finds the token screen, so a simulator signed in as another account has to be signed out first (=xcrun simctl keychain reset= while the app is not running). * Contributing To contribute, create a merge request with your changes: #+begin_src sh gitbay mr create --source --target main --title "..." #+end_src