Getting started · HarborPilot
Getting started: ship a new Mac app with HarborPilot
Add your notarization key, connect your Xcode project, set up Sparkle, and release 1.0, step by step with screenshots.
Read the guideStuck on a release or have a question about HarborPilot? Email support and include your HarborPilot version, your macOS version, and what step of the release you were on.
18 articles
Getting started · HarborPilot
Add your notarization key, connect your Xcode project, set up Sparkle, and release 1.0, step by step with screenshots.
Read the guideReleasing · HarborPilot
Write the notes, check the version, let Apple check it, and upload, for an app that's already set up.
Read the guideGetting started · HarborPilot
Bring an app that already updates with Sparkle: HarborPilot finds your key, imports your live feed, and numbers new builds above it.
Read the guideHosting · HarborPilot
Let HarborPilot upload each release: set up Cloudflare R2 from inside the app, or connect an FTP or FTPS server.
Read the guideSecurity · HarborPilot
What a sandboxed app needs for Sparkle updates to install, what Set Up adds for you, and why it never widens your sandbox.
Read the guideReleasing · HarborPilot
Send test builds to beta testers and stable releases to everyone else, with a Sparkle channel or a separate feed.
Read the guideAccount · HarborPilot
What's free, starting the trial, activating and moving a license, offline use, and what each license message means.
Read the guideKeys and Macs · HarborPilot
Back up the key that signs your updates, restore it when it's missing, and move your history, keys, and license to another Mac.
Read the guideTroubleshooting · HarborPilot
What each live check result means, from a missing file to an old feed served from a cache, and how to fix it.
Read the guideSparkle setup · SwiftUI
Add Sparkle 2, configure your signing key and appcast, and test your first update in a SwiftUI macOS app.
Read the guideSparkle hosting · Cloudflare R2
Publish signed archives and a public feed, avoid stale updates, and stay aware of the free-tier limits.
Read the guideTroubleshooting · Apple notarization
Read Apple’s submission logs, diagnose signing and packaging issues, and validate the stapled release.
Read the guideDistribution · Developer ID
Compare capabilities, trust, updates, payments, and the work each distribution channel leaves to you.
Read the guideProduct breakdown · RunnerKit
Explore the roles of RunnerKit, HarborPilot, and Sparkle in a direct-distribution Mac app.
Read the articleAI-assisted development · Direct distribution
Turn an AI-assisted prototype into a reviewed, signed, notarized download with dependable updates.
Read the guideTroubleshooting · Gatekeeper
Separate unsafe downloads from release problems, inspect signatures, and repair the app you ship—not your users’ security settings.
Read the guideIndependent business · Payments, Gatekeeper, and updates
Plan payments, licensing, Gatekeeper trust, updates, and customer support as separate parts of your launch.
Read the guideSecurity · Entitlements
Understand which protections apply to your distribution channel and why notarization doesn’t grant app permissions.
Read the guide