setup-ios

Add iOS App Target

Add an iOS/iPadOS app target to an existing JUCE-Plugin-Starter project. Supports both standalone iOS app and AUv3 Audio Unit extension. Detects whether Visage GPU UI is enabled and creates the appropriate iOS app files.

Note: The macOS AUv3 format is already included in the default FORMATS line in CMakeLists.txt (AU AUv3 VST3 Standalone). This command adds an iOS-specific app target that can host an AUv3 extension for use in iOS DAWs like AUM, GarageBand, or Cubasis.

Implementation

Step 1: Verify Project

1. Check that the current working directory is a JUCE-Plugin-Starter project:

   • CMakeLists.txt must exist
   • .env must exist

2. If any are missing, tell the user this command must be run from a JUCE-Plugin-Starter project root.

3. Check if an iOS target already exists:

   • If CMakeLists.txt contains juce_add_gui_app with iOS configuration, tell the user an iOS target already exists.

Step 2: Detect Visage Status

Check if Visage GPU UI is available:

• If external/visage/ directory exists AND .env contains USE_VISAGE_UI=TRUE → Visage mode
• Otherwise → Plain JUCE mode

Step 3: Detect Project Configuration

Read .env to extract:

• PROJECT_NAME (fallback: directory name)
• PROJECT_BUNDLE_ID (fallback: com.example.appname)
• COMPANY_NAME (fallback: "Company")

Read Source/PluginProcessor.h (if it exists) to understand the audio engine pattern.

Step 4: Confirm

question: "Add iOS app target to this project?"
header: "iOS"
options:
  - label: "Yes, add iOS target (Recommended)"
    description: "Creates App/ directory with iOS-specific files and updates CMakeLists.txt"
  - label: "Cancel"
    description: "No changes will be made"

If Visage mode, note: "Will use Visage GPU-accelerated UI (Metal rendering, native touch events)" If Plain JUCE mode, note: "Will use standard JUCE UI components"

Step 5: Create iOS App Files

Create the App/ directory with these files: