swiftapp/README.md

# idp.global Swift App

Multiplatform SwiftUI scaffold for the personal `idp.global` companion app on iPhone, iPad, Mac, and Apple Watch.

## Included in this first pass

- QR and NFC-based device pairing flows with a seeded preview payload fallback
- NFC authentication now attaches a signed GPS position on supported iPhone hardware
- Mocked approval inbox for accepting or rejecting identity requests
- Notification center with local notification permission flow and a test notification trigger
- Apple Watch companion target with a compact approval-first dashboard and request detail flow
- Shared app state and mock backend boundary so a real API can be connected later

## Open the project

1. Open `swift/IDPGlobal.xcodeproj`.
2. Build the `IDPGlobal` scheme for:
   - `My Mac`
   - an iPad simulator
   - an iPhone simulator
3. Build the `IDPGlobalWatch` scheme for an Apple Watch simulator when you want to verify the companion experience.

## tsswift workflow

From the repo root:

```bash
corepack pnpm install
corepack pnpm swift:doctor
corepack pnpm swift:emulators
corepack pnpm swift:build
corepack pnpm swift:test
corepack pnpm swift:run
corepack pnpm swift:watch
```

This repo now follows the same layout as the other Swift app repos:

- git root at the repo root
- root `package.json`
- root `.smartconfig.json`
- Swift app content under `swift/`

Current `tsswift` behavior here:

- `build` targets macOS, iPhone Simulator, and iPad Simulator in parallel
- `test` targets macOS
- `run` defaults to macOS unless you pass `--platform ios` or `--platform ipad`
- `watch` rebuilds and relaunches macOS, iPhone, and iPad app instances on file changes

The Apple Watch companion is still part of the Xcode project, but `tsswift` is currently configured around the main `IDPGlobal` app targets only.

## Mock QR payload

The app seeds this pairing payload on first launch:

`idp.global://pair?token=swiftapp-demo-berlin&origin=code.foss.global&device=Safari%20on%20Berlin%20MBP`

You can paste it manually, scan it as a QR code, or use the preview pairing action while the backend is still mocked.

For NFC authentication, the app reads the pairing payload from the tag, captures the current device location, signs that GPS position, and submits both together.

## Next integration step

Replace `MockIDPService` with a live service that:

- exchanges the pairing payload and signed NFC location proof for a session token
- loads approval requests and notifications from the backend
- posts approval decisions back to `idp.global`
- syncs session and request state between iPhone and Apple Watch, likely through a shared backend session or WatchConnectivity bridge