Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
39 commits
Select commit Hold shift + click to select a range
12c9702
docs: add iOS design spec and phase-1 implementation plan
thangnm93 Nov 12, 2026
fd98190
docs: refresh the iOS spec and phase-1 plan for develop at 0.4.0
thangnm93 Nov 13, 2026
e65475d
feat: add platform capability flags for iOS
thangnm93 Nov 13, 2026
3aaa81d
feat: keep flutter_pty and desktop-only features off the mobile path
thangnm93 Nov 13, 2026
0493330
feat: add iOS runner (bundle id com.thangnm.yourssh, iOS 16, UIScene)
thangnm93 Nov 13, 2026
0211a22
test: boot the mobile shell and every tab under TargetPlatform.iOS
thangnm93 Nov 13, 2026
ff4ff67
test: assert each tab's screen after switching and rename boot test
thangnm93 Nov 13, 2026
b4c31cd
feat: this-device-only Keychain and no plaintext secret fallback on iOS
thangnm93 Nov 13, 2026
cf041ac
fix: keep host list atomic when a Keychain write fails on iOS
thangnm93 Nov 13, 2026
e4e5d88
feat: tmux default for fresh mobile installs; Ed25519-only key genera…
thangnm93 Nov 13, 2026
94d87ae
feat: background grace, pause and foreground reconnect on iOS
thangnm93 Nov 13, 2026
269b1f6
fix: hold the iOS native plugin strongly; harden pause/resume races
thangnm93 Nov 13, 2026
4b38c6d
fix: stale connect attempts no longer evict the live client; coordina…
thangnm93 Nov 13, 2026
af50a65
feat: keep private keys out of Files and backups; iOS download/share/…
thangnm93 Nov 13, 2026
dd94fe5
fix: retry SFTP only on a dead channel, never on status or local IO e…
thangnm93 Nov 13, 2026
e90ed84
feat: iOS usage strings, encryption declaration and privacy manifest
thangnm93 Nov 13, 2026
4970627
fix: declare disk-space required-reason API in iOS privacy manifest
thangnm93 Nov 13, 2026
b2d20dd
feat: yourssh:// and opt-in ssh:// links on iOS through CliServer
thangnm93 Nov 13, 2026
d6cbec5
fix: lock-safe, capped and exact-match handling of mobile links
thangnm93 Nov 13, 2026
5c16f8f
ci: iOS build, bundle exclusion check and simulator smoke test in pr-…
thangnm93 Nov 13, 2026
071637b
test: assert specific bundle-check failure reasons
thangnm93 Nov 13, 2026
5bde431
ci: signed iOS IPA and TestFlight upload gated on secrets
thangnm93 Nov 13, 2026
952c250
ci: harden iOS signing cleanup and keep the IPA on upload failure
thangnm93 Nov 13, 2026
39f8166
docs: document the iOS build
thangnm93 Nov 13, 2026
97089cd
docs: list the iOS minimum version
thangnm93 Nov 13, 2026
f32dbbf
fix(keys): rebase stale iOS key paths and delete app-owned key files …
thangnm93 Nov 13, 2026
5c8db73
fix(mobile): skip the SFTP dead-channel re-dial while sessions are pa…
thangnm93 Nov 13, 2026
02f1473
fix(mobile): close the LAN pairing server when the app is backgrounded
thangnm93 Nov 13, 2026
aaf8e44
fix(mobile): re-check the lifecycle epoch between foreground steps
thangnm93 Nov 13, 2026
2d32339
perf(sessions): probe hosts concurrently in verifyLive
thangnm93 Nov 13, 2026
1fbfe21
ci(ios): include the run attempt in the build number
thangnm93 Nov 13, 2026
4e232d8
refactor(mobile): use YsColors in the settings tmux row
thangnm93 Nov 13, 2026
df65396
fix(ios): add Photos, Media Library and Location purpose strings
thangnm93 Nov 13, 2026
24e04f8
fix(mobile): restart restored forwards when a stale foreground loses …
thangnm93 Nov 13, 2026
e2b5d32
fix(mobile): guard the SFTP retry against dispose and document hasPau…
thangnm93 Nov 13, 2026
9bec8bd
ci: skip the iOS job for documentation-only pull requests
thangnm93 Nov 14, 2026
f3c720c
build(ios): pin the SwiftPM dependency graph
thangnm93 Nov 14, 2026
5c7cf49
Merge branch 'feature/ios' into feature/ios-phase1
thangnm93 Nov 16, 2026
1d8d2cf
fix(mobile): keep the app hidden until the lock gate has decided
thangnm93 Nov 16, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
91 changes: 89 additions & 2 deletions .github/workflows/pr-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -246,23 +246,110 @@ jobs:
working-directory: app
run: flutter test test/services/cli/

# Decides whether the macOS-runner `ios` job is worth its ~45 minutes: a PR
# that only changes documentation (tool/ios_ci_needed.sh) skips it. The
# checkout is the PR merge commit, so HEAD^1 is the base branch tip.
changes:
runs-on: ubuntu-latest
outputs:
ios: ${{ steps.diff.outputs.ios }}
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
with:
fetch-depth: 2

- name: Changed files
id: diff
run: |
ios=$( (git diff --name-only HEAD^1 HEAD || true) | bash tool/ios_ci_needed.sh)
echo "ios=$ios"
echo "ios=$ios" >> "$GITHUB_OUTPUT"

# iOS: unit tests that touch Darwin paths, a simulator build, the release
# build with the bundle exclusion check (no desktop-only code or ATS opt-out
# in the .app), and a launch smoke test on a booted simulator. No signing and
# no secrets: --no-codesign. Skipped for documentation-only PRs.
ios:
needs: changes
if: needs.changes.outputs.ios == 'true'
runs-on: macos-latest
timeout-minutes: 45
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7

- uses: subosito/flutter-action@1a449444c387b1966244ae4d4f8c696479add0b2 # v2
with:
channel: stable
flutter-version: ${{ env.FLUTTER_VERSION }}

- name: Install dependencies
working-directory: app
run: flutter pub get

- name: Test (mobile, platform, util)
working-directory: app
run: flutter test test/mobile test/platform test/util

- name: Build for simulator
working-directory: app
run: flutter build ios --simulator --no-codesign

- name: Build release and check the bundle
working-directory: app
run: |
flutter build ios --release --no-codesign
bash ../tool/check_ios_bundle.sh build/ios/iphoneos/Runner.app

- name: Boot an iPhone simulator
id: sim
run: |
udid=$(xcrun simctl list devices available --json | python3 -c '
import json, sys
rts = json.load(sys.stdin)["devices"]
def ver(k):
tail = k.rsplit("iOS-", 1)[-1]
return tuple(int(x) for x in tail.split("-") if x.isdigit())
for k in sorted((k for k in rts if "iOS-" in k), key=ver, reverse=True):
phones = [d for d in rts[k] if d["name"].startswith("iPhone")]
if phones:
print(phones[0]["udid"])
break
')
[ -n "$udid" ] || { echo "no iPhone simulator available"; exit 1; }
xcrun simctl boot "$udid"
xcrun simctl bootstatus "$udid" -b
echo "udid=$udid" >> "$GITHUB_OUTPUT"

- name: Simulator smoke test
working-directory: app
run: flutter test integration_test/ios_smoke_test.dart -d "${{ steps.sim.outputs.udid }}"

# Aggregate gate. master's branch protection requires a check literally named
# "test", so that name has to survive the split — this job carries it, and it
# is red unless every job above is green. `always()` matters: without it the
# job would be skipped when something fails, leaving the required check pending
# forever instead of failing.
test:
name: test
needs: [app, ui, bridge, android, cli, windows-cli]
needs: [app, ui, bridge, android, cli, windows-cli, ios, changes]
if: always()
runs-on: ubuntu-latest
steps:
- name: Check job results
env:
IOS_NEEDED: ${{ needs.changes.outputs.ios }}
run: |
echo "app=${{ needs.app.result }} ui=${{ needs.ui.result }} bridge=${{ needs.bridge.result }} android=${{ needs.android.result }} cli=${{ needs.cli.result }} windows-cli=${{ needs.windows-cli.result }}"
echo "app=${{ needs.app.result }} ui=${{ needs.ui.result }} bridge=${{ needs.bridge.result }} android=${{ needs.android.result }} cli=${{ needs.cli.result }} windows-cli=${{ needs.windows-cli.result }} ios=${{ needs.ios.result }} changes=${{ needs.changes.result }}"
[ "${{ needs.changes.result }}" = "success" ] || exit 1
[ "${{ needs.app.result }}" = "success" ] || exit 1
[ "${{ needs.ui.result }}" = "success" ] || exit 1
[ "${{ needs.bridge.result }}" = "success" ] || exit 1
[ "${{ needs.android.result }}" = "success" ] || exit 1
[ "${{ needs.cli.result }}" = "success" ] || exit 1
[ "${{ needs.windows-cli.result }}" = "success" ] || exit 1
# Skipped only when the changes job said documentation-only.
if [ "$IOS_NEEDED" = "false" ]; then
[ "${{ needs.ios.result }}" = "skipped" ] || exit 1
else
[ "${{ needs.ios.result }}" = "success" ] || exit 1
fi
198 changes: 198 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -585,6 +585,204 @@ jobs:
YourSSH-${{ steps.version.outputs.version }}-Android.apk
YourSSH-${{ steps.version.outputs.version }}-Android-symbols.zip

# ── iOS ────────────────────────────────────────────────────────────────────
# Goes to TestFlight, not to the GitHub release page, so `release` does not
# need this job. The mobile UI is SSH-only: no Rust native libraries.
build-ios:
needs: test
runs-on: macos-latest
# Signing and upload run only when all secrets exist (forks and
# unconfigured repos still get an unsigned, bundle-checked build). Secrets:
# IOS_DISTRIBUTION_P12_BASE64 base64 of the exported Apple
# Distribution certificate + private key
# IOS_DISTRIBUTION_P12_PASSWORD password set when exporting the .p12
# IOS_PROVISIONING_PROFILE_BASE64 base64 of the App Store provisioning
# profile named "YourSSH App Store"
# ASC_KEY_ID / ASC_ISSUER_ID App Store Connect API key id / issuer
# ASC_API_KEY_P8_BASE64 base64 of that key's AuthKey_*.p8
env:
IOS_SIGNING: ${{ secrets.IOS_DISTRIBUTION_P12_BASE64 != '' && secrets.IOS_PROVISIONING_PROFILE_BASE64 != '' && secrets.ASC_KEY_ID != '' && secrets.ASC_ISSUER_ID != '' && secrets.ASC_API_KEY_P8_BASE64 != '' }}
steps:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4

- uses: subosito/flutter-action@1a449444c387b1966244ae4d4f8c696479add0b2 # v2
with:
channel: stable
flutter-version: ${{ env.FLUTTER_VERSION }}

- name: Install dependencies
working-directory: app
run: flutter pub get

- name: Extract version
id: version
run: |
VERSION=$(grep '^version:' app/pubspec.yaml | sed 's/^version:[[:space:]]*//' | cut -d'+' -f1)
echo "version=$VERSION" >> $GITHUB_OUTPUT

# ── Unsigned path (secrets missing) ──
- name: Build iOS (unsigned)
if: env.IOS_SIGNING != 'true'
working-directory: app
run: flutter build ios --release --no-codesign --split-debug-info=build/symbols

- name: Check bundle (unsigned)
if: env.IOS_SIGNING != 'true'
run: bash tool/check_ios_bundle.sh app/build/ios/iphoneos/Runner.app

- name: Zip unsigned app
if: env.IOS_SIGNING != 'true'
run: |
ditto -c -k --sequesterRsrc --keepParent app/build/ios/iphoneos/Runner.app \
"YourSSH-${{ steps.version.outputs.version }}-iOS-unsigned.zip"

# ── Signed path ──
- name: Import Apple Distribution certificate
if: env.IOS_SIGNING == 'true'
env:
CERT_P12_BASE64: ${{ secrets.IOS_DISTRIBUTION_P12_BASE64 }}
CERT_PASSWORD: ${{ secrets.IOS_DISTRIBUTION_P12_PASSWORD }}
run: |
KEYCHAIN="$RUNNER_TEMP/signing.keychain-db"
KEYCHAIN_PASSWORD="$(openssl rand -hex 24)"
echo "::add-mask::$KEYCHAIN_PASSWORD"
echo "$CERT_P12_BASE64" | base64 --decode > "$RUNNER_TEMP/cert.p12"
chmod 600 "$RUNNER_TEMP/cert.p12"
security create-keychain -p "$KEYCHAIN_PASSWORD" "$KEYCHAIN"
# Exported right away so the always() cleanup deletes the keychain
# even when the import below fails (e.g. wrong .p12 password).
echo "SIGN_KEYCHAIN=$KEYCHAIN" >> "$GITHUB_ENV"
security set-keychain-settings -lut 21600 "$KEYCHAIN"
security unlock-keychain -p "$KEYCHAIN_PASSWORD" "$KEYCHAIN"
security import "$RUNNER_TEMP/cert.p12" -k "$KEYCHAIN" -P "$CERT_PASSWORD" -T /usr/bin/codesign
rm -f "$RUNNER_TEMP/cert.p12"
security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k "$KEYCHAIN_PASSWORD" "$KEYCHAIN" > /dev/null
# Prepend the signing keychain to the search list (word splitting of
# the existing list is intended; runner keychain paths have no spaces).
# shellcheck disable=SC2046
security list-keychains -d user -s "$KEYCHAIN" $(security list-keychains -d user | tr -d '"')
IDENTITY=$(security find-identity -v -p codesigning "$KEYCHAIN" | awk '/Apple Distribution/ {print $2; exit}')
if [ -z "$IDENTITY" ]; then
echo "::error::The .p12 holds no Apple Distribution identity"
exit 1
fi

# Fails early with a clear message when the profile is not the one the
# Runner target's Release settings and ExportOptions.plist expect. Never
# prints profile contents.
- name: Install provisioning profile
if: env.IOS_SIGNING == 'true'
env:
PROFILE_BASE64: ${{ secrets.IOS_PROVISIONING_PROFILE_BASE64 }}
run: |
EXPECTED_NAME="YourSSH App Store"
EXPECTED_TEAM="84T567KMYD"
EXPECTED_APPID="84T567KMYD.com.thangnm.yourssh"
echo "$PROFILE_BASE64" | base64 --decode > "$RUNNER_TEMP/profile.mobileprovision"
chmod 600 "$RUNNER_TEMP/profile.mobileprovision"
security cms -D -i "$RUNNER_TEMP/profile.mobileprovision" > "$RUNNER_TEMP/profile.plist"
PB=/usr/libexec/PlistBuddy
NAME=$($PB -c 'Print :Name' "$RUNNER_TEMP/profile.plist" 2>/dev/null || true)
TEAMS=$($PB -c 'Print :TeamIdentifier' "$RUNNER_TEMP/profile.plist" 2>/dev/null || true)
APPID=$($PB -c 'Print :Entitlements:application-identifier' "$RUNNER_TEMP/profile.plist" 2>/dev/null || true)
UUID=$($PB -c 'Print :UUID' "$RUNNER_TEMP/profile.plist" 2>/dev/null || true)
rm -f "$RUNNER_TEMP/profile.plist"
FAILED=0
if [ "$NAME" != "$EXPECTED_NAME" ]; then
echo "::error::Provisioning profile Name must be '$EXPECTED_NAME'"
FAILED=1
fi
if ! printf '%s\n' "$TEAMS" | grep -qw "$EXPECTED_TEAM"; then
echo "::error::Provisioning profile TeamIdentifier must contain $EXPECTED_TEAM"
FAILED=1
fi
if [ "$APPID" != "$EXPECTED_APPID" ]; then
echo "::error::Provisioning profile application-identifier must be $EXPECTED_APPID"
FAILED=1
fi
if [ -z "$UUID" ]; then
echo "::error::Provisioning profile has no UUID"
FAILED=1
fi
if [ "$FAILED" -ne 0 ]; then
rm -f "$RUNNER_TEMP/profile.mobileprovision"
exit 1
fi
PROFILES_DIR="$HOME/Library/MobileDevice/Provisioning Profiles"
mkdir -p "$PROFILES_DIR"
mv "$RUNNER_TEMP/profile.mobileprovision" "$PROFILES_DIR/$UUID.mobileprovision"
echo "IOS_PROFILE_PATH=$PROFILES_DIR/$UUID.mobileprovision" >> "$GITHUB_ENV"

# Manual signing is set in the Runner target's Release settings only; a
# command-line override would also hit the SPM/CocoaPods targets.
- name: Build signed IPA
if: env.IOS_SIGNING == 'true'
working-directory: app
run: |
# run_number repeats on "Re-run failed jobs"; the attempt keeps the
# build number monotonic (App Store Connect rejects duplicates).
BUILD_NUMBER=$(( ${{ github.run_number }} * 100 + ${{ github.run_attempt }} ))
flutter build ipa --release \
--export-options-plist=ios/ExportOptions.plist \
--build-number="$BUILD_NUMBER" \
--split-debug-info=build/symbols

- name: Check bundle (signed)
if: env.IOS_SIGNING == 'true'
run: bash tool/check_ios_bundle.sh app/build/ios/archive/Runner.xcarchive/Products/Applications/Runner.app

- name: Name the IPA and zip debug symbols
if: env.IOS_SIGNING == 'true'
run: |
IPA=$(find app/build/ios/ipa -name '*.ipa' -maxdepth 1 | head -1)
mv "$IPA" "YourSSH-${{ steps.version.outputs.version }}-iOS.ipa"
cd app/build/symbols
zip -r "$GITHUB_WORKSPACE/YourSSH-${{ steps.version.outputs.version }}-iOS-symbols.zip" .

- name: Upload to TestFlight
if: env.IOS_SIGNING == 'true'
env:
ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }}
ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
ASC_API_KEY_P8_BASE64: ${{ secrets.ASC_API_KEY_P8_BASE64 }}
run: |
KEY_DIR="$RUNNER_TEMP/private_keys"
mkdir -p "$KEY_DIR"
echo "$ASC_API_KEY_P8_BASE64" | base64 --decode > "$KEY_DIR/AuthKey_$ASC_KEY_ID.p8"
chmod 600 "$KEY_DIR/AuthKey_$ASC_KEY_ID.p8"
IPA="YourSSH-${{ steps.version.outputs.version }}-iOS.ipa"
if [ ! -f "$IPA" ]; then
echo "::error::$IPA is missing"
exit 1
fi
API_PRIVATE_KEYS_DIR="$KEY_DIR" xcrun altool --upload-app -f "$IPA" -t ios \
--apiKey "$ASC_KEY_ID" --apiIssuer "$ASC_ISSUER_ID"

- name: Remove signing material
if: always()
run: |
if [ -n "$SIGN_KEYCHAIN" ]; then security delete-keychain "$SIGN_KEYCHAIN" || true; fi
if [ -n "$IOS_PROFILE_PATH" ]; then rm -f "$IOS_PROFILE_PATH"; fi
rm -f "$RUNNER_TEMP/profile.mobileprovision" "$RUNNER_TEMP/profile.plist" "$RUNNER_TEMP/cert.p12"
rm -rf "$RUNNER_TEMP/private_keys"

- uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
if: env.IOS_SIGNING != 'true'
with:
name: ios
if-no-files-found: error
path: YourSSH-${{ steps.version.outputs.version }}-iOS-unsigned.zip

# always(): a failed TestFlight upload still leaves the IPA to debug.
- uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
if: always() && env.IOS_SIGNING == 'true'
with:
name: ios
if-no-files-found: ignore
path: |
YourSSH-${{ steps.version.outputs.version }}-iOS.ipa
YourSSH-${{ steps.version.outputs.version }}-iOS-symbols.zip

release:
runs-on: ubuntu-latest
needs: [build-macos, build-windows, build-linux, build-android]
Expand Down
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- **iOS (iPhone) build, distributed through TestFlight** — the mobile app now runs on iPhone. Hosts, SSH terminal, SFTP and the Keychain screens work as on Android. Secrets live in the iOS Keychain (this-device-only, no plaintext fallback) and imported keys are kept in app storage excluded from backup. The app lock covers the whole app and uses Face ID; the connection is kept for a short grace period in the background and reconnects on return. `yourssh://connect/<host>` links work, and `ssh://` links are an opt-in setting that never connects to an unknown target. Local shell, RDP and VNC are desktop-only. Not on the App Store yet.

### Fixed
- RDP and VNC hosts show a "desktop only" notice on mobile instead of failing to connect.
- Imported SSH keys are copied into app storage, so they keep working after the source file moves or the picker's temporary copy is removed.

## [0.4.1] — 2026-11-13

Security and polish fixes found while writing the documentation (now at https://yoursshlabs.com).
Expand Down
13 changes: 12 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ cd app && flutter test integration_test/vnc_screenshots_test.dart -d macos

## Architecture

The active codebase is `app/` — a Flutter app targeting macOS, Windows, and Linux. The in-app RDP client is implemented as the `packages/yourssh_rdp` Rust crate bridged via `flutter_rust_bridge` v2; the old `core/` Swift-bridge Rust library has been removed.
The active codebase is `app/` — a Flutter app targeting macOS, Windows, and Linux, plus Android and iOS through `app/lib/mobile`. The in-app RDP client is implemented as the `packages/yourssh_rdp` Rust crate bridged via `flutter_rust_bridge` v2; the old `core/` Swift-bridge Rust library has been removed.

**Monorepo layout:**
- `app/` — the Flutter app
Expand Down Expand Up @@ -199,6 +199,17 @@ Flutter UI (widgets/screens)

**Code editor:** `CodeEditorScreen` renders a Monaco editor via `webview_flutter` using the bundled `assets/monaco_editor.html`.

## iOS

The iPhone build shares `app/lib/mobile` with Android. Platform gates live in `app/lib/platform/runtime_platform.dart` (`isIOSPlatform`, `supportsRemoteDesktop`, `supportsSubprocesses`, `mobileDefaultTmux`). There is no simulator runtime on the owner's Mac: launching is CI-only (pr-test `ios` job) or manual; locally run `cd app && flutter build ios --simulator --no-codesign` and `flutter build ios --release --no-codesign`.

- **Runner**: UIScene runner (`SceneDelegate.swift`); `YourSshNative` (`app/ios/Runner/YourSshNative.swift`) is registered from `didInitializeImplicitFlutterEngine` and held strongly. Channels: `yourssh/url`, `yourssh/ssh_url`, `yourssh/background`, `yourssh/files`.
- **Lifecycle**: `MobileLifecycleCoordinator` runs grace / pause / resume with epochs; `SshSession.paused` / `acceptsInput` make input to a non-connected session fail visibly.
- **Secrets**: `StorageService.iosKeychainOptions` (`first_unlock_this_device`, not synchronizable); no plaintext prefs fallback on iOS. `AppPaths` puts keys in Application Support, excluded from backup.
- **Links**: `yourssh://` goes through `CliServer` + `UrlChannel`; `ssh://` is an opt-in iOS-only setting, never connects to an unknown target and is deferred while `mobileAppLocked` is true.
- **Compliance**: `PrivacyInfo.xcprivacy` (UserDefaults CA92.1, FileTimestamp C617.1, DiskSpace E174.1), `ITSAppUsesNonExemptEncryption = YES`, no `NSAppTransportSecurity` key.
- **CI**: `tool/check_ios_bundle.sh <Runner.app>` rejects QuickJS / RDP / VNC / flutter_pty artifacts, the `pty_forkpty` symbol and any `NSAppTransportSecurity` key; the pr-test `ios` job runs unit tests, simulator and release builds, the bundle check and a simulator smoke test (a `changes` job skips it when `tool/ios_ci_needed.sh` finds only documentation changes: `*.md`, `docs/`, `screenshots/`, `.claude/`). The two iOS `Package.resolved` files (`app/ios/Runner.xcworkspace/…` and `app/ios/Runner.xcodeproj/project.xcworkspace/…`) are committed so the signed build pins file_picker's branch-tracked SwiftPM dependencies (DKCamera, DKPhotoGallery); the macOS ones stay untracked. release.yml `build-ios` builds a signed IPA and uploads to TestFlight (needs secrets `IOS_DISTRIBUTION_P12_BASE64`, `IOS_DISTRIBUTION_P12_PASSWORD`, `IOS_PROVISIONING_PROFILE_BASE64`, `ASC_KEY_ID`, `ASC_ISSUER_ID`, `ASC_API_KEY_P8_BASE64`; the App Store profile must be named `YourSSH App Store`; `app/ios/ExportOptions.plist`); the IPA is not attached to the GitHub release.

## Plugin system

Two plugin types coexist:
Expand Down
Loading
Loading