mobile

notifyhub-ios

Native SwiftUI client for notifyhub with APNs push and live subscriptions.

GitHub repo (opens in a new tab) ↗

~/problem

Shows the notifyhub push contract working from the client side: token registration, rotation, revocation and routing a tap to the right channel.

A Swift and SwiftUI app that signs in to notifyhub, browses and subscribes to channels, shows notifications with live GraphQL subscription updates, and registers APNs device tokens. Push taps deep-link in foreground, background and killed states.

~/highlights

  • Hand-written GraphQL client over URLSession for queries, mutations and a graphql-transport-ws subscription.
  • Keychain-backed token storage; tests need ad-hoc signing to access the keychain.
  • XcodeGen project.yml generates the project; no .xcodeproj is committed.
  • DeepLinkCoordinator handles push routing in all three app states.
  • Push payload keys must match notifyhub's APNs payload builder; the contract is noted in both repos.
  • Only the macos-15 CI job compiles this code; a manual workflow captures a simulator screenshot.

~/architecture

Architecture of notifyhub-iosSwiftUI views connects to Repositories. Repositories connects to GraphQL client. GraphQL client connects to notifyhub. Push layer connects to Repositories, SwiftUI views. notifyhub has no outgoing connections.SwiftUI viewsRepositoriesGraphQL clientPush layernotifyhub
SwiftUI views → Repositories
Sign in, channels, notification list.
Repositories → GraphQL client
One struct per area wrapping GraphQLClient.
GraphQL client → notifyhub
HTTP operations plus a WebSocket subscription client.
Push layer → Repositories, SwiftUI views
Device token registration and DeepLinkCoordinator.
notifyhub
GraphQL backend in the paired repository.

~/stack

  • Swift
  • SwiftUI
  • GraphQL
  • APNs
  • Keychain
  • XcodeGen

~/status

Complete. Written without a Swift compiler in the authoring sandbox, so CI on macOS is the only compile check. Real APNs delivery to a physical device is a permanent unverified limit. MIT.

  • notifyhub GraphQL notification service with live subscriptions over WebSocket.