macos-spm-app-packaging
by dimillian
iOS & macOS DevelopmentBrief
Scaffold, build, and package SwiftPM-based.
Description
What This Skill Does
Scaffolds, builds, and packages SwiftPM-based macOS apps without an Xcode project file. Provides template scripts for .app bundle assembly, code signing, notarization, and Sparkle appcast generation. Covers the full lifecycle from project bootstrap to GitHub release.
Removes the need for an Xcode project file, making the entire build and release pipeline scriptable and CI-friendly.
When to Use It
- Setting up a new macOS menu bar app without Xcode
- Packaging a SwiftPM binary into a distributable .app bundle
- Automating notarization and stapling for a release build
- Generating Sparkle appcast entries for over-the-air updates
- Creating a dev-loop script that rebuilds and relaunches on each change
Example Workflow
User asks: scaffold a new macOS menu bar app and package it for distribution
- 1
Copy assets/templates/bootstrap/ into the new repo directory
- 2
Rename MyApp references in Package.swift, Sources/, and version.env
- 3
Set APP_NAME, BUNDLE_ID, and MENU_BAR_APP=1 in the packaging script
- 4
Run swift build to verify the project compiles
- 5
Run Scripts/package_app.sh to produce the signed .app bundle
A signed .app bundle ready for notarization or direct distribution
Requirements
- Apple Developer account (for code signing and notarization)
- APPLE_ID, APP_PASSWORD, and TEAM_ID environment variables for notarization
- Xcode command-line tools (for build_icon.sh only)
Installation
clawhub install dimillian/macos-spm-app-packagingRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.