Recommended IDE for Palmier Pro Development: Why Xcode 16 Is Required

Xcode 16 or newer is the recommended IDE for Palmier Pro development because it is the only environment that fully supports the Swift 6.2 toolchain, SwiftUI live previews, and Apple-specific frameworks required by this macOS-only application.

Palmier Pro is a pure-Swift macOS application maintained in the palmier-io/palmier-pro repository. According to the project's CONTRIBUTING.md, development requires specific Apple tooling that third-party editors cannot fully replicate. Understanding the recommended IDE for Palmier Pro development ensures you can compile the source, debug SwiftUI interfaces, and run the test suite without toolchain conflicts.

Why Xcode 16 Is the Recommended IDE

The Palmier Pro codebase utilizes SwiftUI, AppKit, and AVFoundation, making Xcode the exclusive choice for complete development workflow integration.

Official Toolchain Requirements

As defined in CONTRIBUTING.md (lines 11-15), the project requires:

• macOS 26+
• Xcode 16+
• Swift 6.2 toolchain

These prerequisites are non-negotiable because Package.swift declares the platform as macOS 26 and depends on language features introduced in Swift 6.2. While you can edit Swift files in any text editor, Xcode is the only IDE that can directly compile, run, and debug the macOS binary with full UI-related tooling support.

Native Framework Support

Xcode provides integrated capabilities essential for Palmier Pro development:

• Integrated Swift compiler and package manager (swift build, swift test) without command-line configuration
• Full-screen SwiftUI preview and live UI debugging for real-time interface iterations
• Built-in support for Apple-specific frameworks including AppKit and AVFoundation
• Automated signing and entitlements management for Apple Silicon target architecture

Setting Up Palmier Pro in Xcode

Generate and Open the Project

Since Palmier Pro uses Swift Package Manager, you must generate an Xcode project from the manifest:

# Clone the repository

git clone https://github.com/palmier-io/palmier-pro
cd palmier-pro

# Generate Xcode project from Package.swift

swift package generate-xcodeproj

# Open the generated workspace

open PalmierPro.xcodeproj

This creates an Xcode project containing all Swift sources, resources, and the Package.swift manifest dependencies.

Build and Run

Once inside Xcode:

1. Select the PalmierPro scheme from the dropdown
2. Choose My Mac (Apple Silicon) as the destination
3. Press ⌘R (Run)

Xcode compiles the app using the Swift 6.2 toolchain and launches the binary on your local machine.

Alternative Development Script

For rapid iteration without switching Xcode schemes, use the provided development script:

# Runs debug build and streams OSLog output

./scripts/dev.sh

This script executes swift build and launches the resulting .app, functioning perfectly alongside the Xcode workflow for quick rebuilds.

Key Source Files Requiring Xcode

Several critical components benefit specifically from Xcode's tooling:

• Package.swift – Declares the Swift package, platform requirements (macOS 26), and Swift 6.2 toolchain version
• Sources/PalmierPro/UI/AppTheme.swift – Central UI design system best edited and previewed in Xcode's SwiftUI canvas
• Sources/PalmierPro/Editor/EditorView.swift – Core editor UI utilizing Interface Builder and live UI debugging features
• CONTRIBUTING.md – Documents the required development tools (Xcode 16+, Swift 6.2)
• scripts/dev.sh – Convenience build script that complements the Xcode workflow

Summary

• Xcode 16 or newer is the only fully compatible IDE for Palmier Pro development according to the official CONTRIBUTING.md
• The project requires Swift 6.2 and macOS 26 platform support available exclusively through Xcode's integrated toolchain
• Generate the project using swift package generate-xcodeproj before opening in Xcode
• Files like AppTheme.swift and EditorView.swift utilize SwiftUI previews that only render correctly in Xcode

Frequently Asked Questions

Can I use Visual Studio Code for Palmier Pro development?

While you can open and edit Swift source files in VS Code, you cannot compile, debug, or run the Palmier Pro application without Xcode. The project depends on Apple-specific frameworks (AppKit, AVFoundation) and SwiftUI previews that require Xcode's proprietary toolchain and simulator. Use VS Code only for text editing, then switch to Xcode for building and testing.

What specific Xcode version does Palmier Pro require?

The repository requires Xcode 16 or newer, as documented in CONTRIBUTING.md (lines 11-15). This version includes the Swift 6.2 compiler and macOS 26 SDK necessary to resolve the package dependencies declared in Package.swift. Attempting to build with Xcode 15 or earlier will fail due to missing language features and platform support.

Does Palmier Pro support development on Linux or Windows?

No. Palmier Pro is a macOS-only application targeting Apple Silicon architecture. The codebase imports AppKit and AVFoundation frameworks unavailable on Linux or Windows. Even with cross-platform Swift toolchains, you cannot compile or run this application without macOS 26 and the native Xcode environment.

How do I run the test suite in the recommended IDE?

Press ⌘U (Test) in Xcode or navigate to the Test navigator panel. Xcode executes the Swift test suite covering timeline, rendering, AI, and media handling modules. Alternatively, run swift test from Terminal, but Xcode provides UI-based test reporting and breakpoint debugging essential for diagnosing failures in view-layer tests.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}