source-command-maccatalyst-run

Use this skill when the user asks to run the migrated source command maccatalyst-run.

Command Template

Mac Catalyst Run

Build and launch the ActualChat (Voxt) Mac Catalyst app on the local Mac.

Prerequisites

• macOS host with the .NET MAUI workload and the maccatalyst target (dotnet workload list shows maui)
• Xcode command line tools installed (xcode-select --install)

Usage

Run the ./scripts/run-maccatalyst.sh script which:

1. Picks the Mac Catalyst RID for the host CPU (maccatalyst-arm64 on Apple Silicon, maccatalyst-x64 on Intel)
2. Builds the JS bundle (npm run build:Debug)
3. Builds the Mac Catalyst app (net11.0-maccatalyst target)
4. Locates the produced .app bundle (Voxt (Dev).app for dev, Voxt.app for prod)
5. Terminates any previous instance and launches the app binary directly so logs stream to the terminal

Command

./scripts/run-maccatalyst.sh

Note: The app binary is run directly (not via open), so this script runs until the app is quit. The console output shows app logs in real-time.

Output

The script outputs:

• Build progress and warnings
• The resolved RID and .app path
• App launch confirmation
• Live console logs from the app

Troubleshooting

If the script fails:

• No .app found: confirm the build succeeded and check artifacts/bin/App.Maui/debug_net11.0-maccatalyst_<RID>/
• Build errors: build the target on its own with dotnet build src/dotnet/App.Maui/ -f net11.0-maccatalyst
• Missing workload: run dotnet workload install maui (or maccatalyst)
• App talks to the wrong backend: the dev build (IsDevMaui=true, the default) targets the dev instance; pass -p:IsDevMaui=false to the build for prod