Files

Claude 2cff17fa0d Phase 0: scaffold

Two SPM packages (VNCCore, VNCUI) + thin iOS app target wired via
xcodegen. Builds for iPhone 17 simulator, unit tests pass.

- VNCCore: SessionState, SessionController stub, Transport protocol
  with DirectTransport (NWConnection), DiscoveryService (Bonjour on
  _rfb._tcp and _workstation._tcp), SavedConnection @Model,
  ConnectionStore, KeychainService, ClipboardBridge
- VNCUI: ConnectionListView, AddConnectionView, SessionView,
  FramebufferView/FramebufferUIView (UIKit CALayer), InputMapper,
  SettingsView; UIKit bits guarded with #if canImport(UIKit) so
  swift test runs on macOS
- App: @main VNCApp, AppStateController state machine, RootView
- RoyalVNCKit dependency pinned to main (transitive CryptoSwift
  constraint blocks tagged releases)
- xcodegen Project.yml + README + .gitignore

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-16 19:29:47 -05:00

1.8 KiB

Raw Blame History

Screens (working title)

A VNC / RFB remote-desktop client for iPhone and iPad, modeled on Screens by Edovia. See /Users/treyt/.claude/plans/i-want-to-make-sprightly-pike.md for the full plan.

The name "Screens" is owned by Edovia. Pick a different App Store name before any public release.

Layout

Screens/
├── Screens/           # iOS app target (thin shell: @main, RootView, AppStateController)
├── Packages/
│   ├── VNCCore/       # Protocol + transport + storage. Tested with `swift test`.
│   └── VNCUI/         # SwiftUI views + UIKit framebuffer. Tested in-simulator.
├── Project.yml        # xcodegen project definition — generates the .xcodeproj
├── README.md
└── .gitignore

Setup

Install xcodegen:
```
brew install xcodegen
```
Generate the Xcode project from the repo root:
```
xcodegen generate
```
Open Screens.xcodeproj in Xcode 16+. First open resolves the RoyalVNCKit SPM dependency.
Select an iOS 18 simulator (or a signed device) and run.

Testing

# Fast unit tests (no simulator)
cd Packages/VNCCore && swift test
cd Packages/VNCUI   && swift test

# Full app + UI tests (simulator)
xcodebuild -project Screens.xcodeproj -scheme Screens -destination 'platform=iOS Simulator,name=iPhone 16' test

Phase 0 status

Scaffold only. Tapping a saved connection starts a SessionController but it only opens the TCP socket — no RFB handshake yet. Phase 1 wires RoyalVNCKit into SessionController and implements framebuffer rendering.

Dependencies

RoyalVNCKit (MIT) — RFB protocol, encodings, auth.
Apple first-party only: Network, SwiftData, Security, UIKit, SwiftUI, Observation.

1.8 KiB Raw Blame History