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 | Any Forgejo 15.x instance (Gitea 1.22-compatible API), reachable over HTTPS |
| Account | A Fjord Account or a Forgejo personal access token |
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.
Pointing the app at a self-hosted Forgejo instance that Fjord does not host for
you (a custom server) requires a Pro account. This is a mobile-app requirement;
the fj CLI connects to any Forgejo host with a
personal access token at no extra cost.
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