Apple Flow

Build, export, and ship the Swift onboarding/dashboard app.

macOS GUI App Export

Apple Flow includes an optional native macOS Swift app for:

  • guided onboarding and setup checks
  • .env preview/apply workflow
  • runtime operations (service controls, approvals, sessions, events, logs, config)

The app source lives in apps/macos/AppleFlowApp.

Screenshots

Audit Events TimelineLog Stream Viewer
Swift Dashboard Events TabSwift Dashboard Logs Tab
Control Panel OverviewConfig Editor
Swift Dashboard Overview TabSwift Dashboard Config Tab
Onboarding Error (Doctor Checks)
Swift Onboarding Error: Full Disk Access Needed
Setup Configuration + Env Preview
Swift Onboarding Setup Configuration and Env Preview

Build and Run

From repo root:

# Open in Xcode
./apps/macos/AppleFlowApp/scripts/open_in_xcode.sh

# Build + export standalone app and zip to dist/
./apps/macos/AppleFlowApp/scripts/export_app.sh

# Launch exported app (builds first if missing)
./apps/macos/AppleFlowApp/scripts/run_standalone.sh

Artifacts produced by export:

  • dist/AppleFlowApp.app
  • dist/AppleFlowApp-macOS.zip

Prebuilt Bundle in Repository

The repository may include a prebuilt copy under dashboard-app/:

  • dashboard-app/AppleFlowApp.app
  • dashboard-app/AppleFlowApp-macOS.zip

Use the scripts above to rebuild from source when needed.