Fjord for iOS and iPadOS
Fjord Mobile is a universal iPhone and iPad client for self-hosted Forgejo, built to feel like GitHub Mobile against your own forge. It is one binary that adapts to the device: a single-column flow on iPhone, a multi-column layout on iPad.
Requirements
| Devices | iPhone and iPad (universal) |
| OS | iOS / iPadOS 17 or later |
| Server | Forgejo 7.0 or later (Gitea 1.22-compatible API), reachable over HTTPS. Actions needs 15+; run logs, cancelling a run, and artifacts need 16+. |
| Account | A Forgejo personal access token, or an optional Fjord Account |
Fjord is built with SwiftUI and Swift 6 strict concurrency, and talks to a
typed ForgejoKit client generated from the shared Forgejo API contract, so the
app only ever calls endpoints the server actually exposes.
Getting the app
Fjord Mobile is live on the App Store. Search for “Fjord Mobile” on your iPhone or iPad, or open the store listing from fjord.sh, and install it like any other app. One universal download runs natively on both iPhone and iPad.
The app is not tied to the hosted platform: point it at any Forgejo instance you can reach and sign in. Release notes for each version are published on fjord.sh.
Connecting to your forge
On first launch you sign in once and Fjord remembers the host and credential in the iOS Keychain. There are two ways to connect, covered in detail on Signing in:
- Fjord Account for the hosted platform, with email, password, and TOTP.
- Personal access token for any Forgejo instance, by hostname.
Point the app directly at any self-hosted Forgejo 7.0+ instance over HTTPS with
a personal access token — no Fjord Account and no plan required, the same as
the fj CLI. The token stays on the device, and a
direct session holds one server at a time. A Fjord Account is optional; it adds
push notifications, notification actions, background Live Activity updates,
multiple accounts, and switching between instances.
What you can do
Inbox
Repositories and code
Issues
Pull requests
Explore and search
Profile and orgs
Fjord is a read-complete client with the everyday write actions wired up: commenting, reactions, labels, pinning, opening and closing issues, merging pull requests, requesting reviews, starring, watching, following, and marking notifications read. Actions that the Forgejo API does not expose yet (for example commit comments and full code search) are not available in the app either.
On iPad
The iPad build is the same app, not a stretched phone screen. It uses a multi-column layout so a list and its detail sit side by side, and it adapts to Split View and Slide Over. There is no separate download: install Fjord and it runs natively on both.
Pair Fjord with the CI actions to close the release loop: a build pings your phone and you approve it from the same app you use to triage issues.
- Stephen Way (agent)