iOS app for pi-remote-control sidecar

Go to file

jay 7be9e64a95 feat: merge T-2.6 SessionSwitcher + T-2.8 StatusBar + T-2.11 Face-ID - SessionRegistry + SessionSwitcher + SessionRow (T-2.6) - StatusBar component with pi-state indicator (T-2.8) - FaceIDGate + SettingsView + LockView (T-2.11) - Reconciled MainTerminalView: StatusBar wired with onSwitcher/onSettings/onUnpair, two .task modifiers, two .sheet modifiers (SessionSwitcher + SettingsView) - AppState: appDidBackground/appWillForeground + isLocked (T-2.11) - ContentView: scenePhase tracking + LockView overlay (T-2.11) - Pairing.swift: fp param is optional pre-TLS (dev convenience)		2026-05-16 11:54:12 +02:00
Sources	feat: merge T-2.6 SessionSwitcher + T-2.8 StatusBar + T-2.11 Face-ID	2026-05-16 11:54:12 +02:00
Tests/CoreTests	test(T-2.4/2.5/2.9): ModifierState, ScrollbackCache, DeviceTokenRegistrar tests	2026-05-15 19:03:56 +02:00
docs	docs: fix trailing slash in pair-qr curl command	2026-05-16 02:58:18 +02:00
piRemote.xcodeproj	feat: app wiring — ContentView + AppState + MainTerminalView	2026-05-16 02:48:08 +02:00
.gitignore	feat(T-2.0): Xcode project scaffold — SwiftUI shell, SwiftTerm + Starscream SPM deps	2026-05-15 13:19:48 +02:00
README.md	docs: update status table — T-2.0..T-2.5+T-2.9 done	2026-05-16 02:42:02 +02:00
project.yml	feat(T-2.0): Xcode project scaffold — SwiftUI shell, SwiftTerm + Starscream SPM deps	2026-05-15 13:19:48 +02:00

README.md

pi-remote iOS

Native iOS app for the pi-remote-control sidecar.

Requirements

Xcode 16.4+
iOS 17.0+ device
pi-remote-control sidecar running (Phase 1)

Building

# Open in Xcode (first time: Xcode downloads device support files automatically)
open piRemote.xcodeproj

# Or via CLI (after first Xcode open with device connected):
xcodebuild build -project piRemote.xcodeproj -scheme piRemote \
  -destination "platform=iOS,name=<YourPhone>" \
  CODE_SIGNING_STYLE=Automatic DEVELOPMENT_TEAM=KNXX8R3648

Project structure

Sources/
├── App/          — @main entry, ContentView, Assets
├── Core/
│   ├── Network/  — WebSocketClient, FrameCodec, ResumeCursor, TLS pinning
│   ├── Auth/     — Keychain, Pairing (QR exchange)
│   ├── Sessions/ — SessionRegistry, SessionConnection, PreConnectPool
│   ├── Push/     — APNs NotificationDelegate, DeviceTokenRegistrar
│   └── Persistence/ — ScrollbackCache, Preferences
└── UI/
    ├── Terminal/ — SwiftTerm wrapper, themes, fonts
    ├── Input/    — ModifierBar, sticky Ctrl, paste sheet
    ├── Status/   — StatusBar (pi state)
    ├── Sessions/ — SessionSwitcher
    ├── Pairing/  — QR scanner flow
    └── Settings/ — Face-ID gate, sidecar info

Dependencies (via SPM)

SwiftTerm — terminal emulator
Starscream — WebSocket client

Apple Developer setup (one-time)

In Apple Developer Portal:
- Create App ID: de.vpsj.pi-remote, enable Push Notifications
- Generate an APNs Auth Key (.p8) — download once, keep safe
- Note your Key ID and Team ID (KNXX8R3648)
Copy .p8 key to ~/.local/share/pi-remote/apns/AuthKey_<KeyID>.p8
Update [apns] section in pi-remote-control config

Status

Phase 2 — in progress.

Task	Status
T-2.0 Xcode scaffold	✅ done
T-2.1 WebSocketClient + FrameCodec + ResumeCursor	✅ done
T-2.2 Pairing + Keychain + QRScanner	✅ done
T-2.3 TerminalView + ThemeStore + FontStore	✅ done
T-2.4 ModifierBar + ModifierState + PasteSheet	✅ done
T-2.5 SessionConnection (IC-2.1) + ScrollbackCache	✅ done
T-2.9 APNs NotificationDelegate + DeviceTokenRegistrar	✅ done
T-2.6 SessionRegistry + SessionSwitcher UI	⛔ next
T-2.7 PreConnectPool	⛔ after T-2.6
T-2.8 StatusBar + Side-channel	⛔ next
T-2.10 Background lifecycle	⛔ todo
T-2.11 Face-ID gate + Settings	⛔ next
T-2.12 TestFlight pipeline	⛔ todo
T-2.13 MVP smoke test	⛔ last

App runs on device: iOS 26, wireless, Xcode 16.4 Intel Mac.
111 unit tests across FrameCodec, ResumeCursor, Pairing, Keychain, Theme, ModifierState, ScrollbackCache, DeviceTokenRegistrar.

See pi-remote-control/docs/PHASE-2-ios-mvp.md for full spec.