Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

iOS/macOS App Development Helper

A field-tested guide for building iOS/macOS apps with XcodeGen, SwiftUI and SPM, plus Apple signing, notarization and CI/CD fixes.

Dev & CodingAdvanced★ 1,323⑂ 212AI score 9/10Last updated: Aug 8, 2026

What it does

  • Gives a minimal XcodeGen project.yml template and shows where to put signing settings so xcodegen generate doesn't wipe them.
  • Explains the root cause of "Library not loaded: @rpath/..." (XcodeGen omits the Embed Frameworks phase for SPM dynamic frameworks) and the one-time fix.
  • Maps iOS 17-only APIs (@Observable, ContentUnavailableView, two-parameter onChange) to iOS 16-compatible equivalents.
  • Covers real-device deployment steps and the free Apple ID vs paid ($99/yr) account matrix.
  • Provides a 5-step checklist for Developer ID certificates, P12 export, App Store Connect API keys and the exact 5 GitHub Secrets needed for macOS/Electron notarization.
  • Includes AVFoundation camera debugging: blank preview, front-camera mirroring crash, zero-size UIViewRepresentable.

Who it's for

  • iOS developers using XcodeGen to avoid .xcodeproj merge conflicts
  • Anyone whose app crashes on launch after adding Realm or other dynamic SPM frameworks
  • Teams shipping macOS apps (native or Electron) outside the App Store and stuck on notarization
  • CI engineers seeing builds silently fall back to adhoc signing in GitHub Actions

Examples

  1. "App dies with a dyld error on a real device" → switch the dynamic framework to 'Embed & Sign' in the Xcode GUI, build once from the GUI, and xcodebuild works afterwards.
  2. "We need to support iOS 16" → lower deploymentTarget to 16.0, swap iOS 17 APIs for compatible code, then re-run xcodegen generate.
  3. "Notarization fails with 'Cannot use password credentials, API key credentials...'" → drop the teamId argument passed to @electron/notarize and rely on the API key alone.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the iOS-APP-developer folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/developing-ios-apps/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/iOS-APP-developer ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open Terminal on macOS (this skill assumes Xcode and a Mac).
  2. Clone the skill repo: git clone https://github.com/daymade/claude-code-skills.git
  3. Create the skills directory: mkdir -p ~/.claude/skills
  4. Copy the skill in: cp -r claude-code-skills/iOS-APP-developer ~/.claude/skills/
  5. Verify with ls ~/.claude/skills/iOS-APP-developer — you should see SKILL.md and a references/ folder.
  6. Restart Claude Code, then ask something like "my XcodeGen build fails" or "set up macOS notarization" to trigger the skill.
  7. Prerequisites: a recent Xcode, brew install xcodegen, and a paid Apple Developer account if you need command-line builds or CI/CD signing.
View source on GitHub ↗License: MIT