Terminal-First macOS App Developer Guide
Build, Package & Ship a macOS App — Entirely from the Command Line

No Xcode GUI. No guesswork. Just Terminal, Swift, and a clear path to a shipped app.

This guide covers the full macOS app distribution pipeline from scratch — signed, packaged, and ready for users — across two paths depending on your budget.

────────────────────────────────────────
WHAT'S INSIDE
────────────────────────────────────────

§01 · Prerequisites & Environment Setup
One verification script confirms your entire environment is ready before you write a single line of Swift.

§02 · The Two Paths Overview
Side-by-side breakdown of free vs paid distribution so you pick the right path for your use case.

§03 · Path A — Free Distribution ($0)
Ad-hoc signing, quarantine removal, Homebrew Cask setup, and GitHub Releases. No Apple Developer Account required.

§04 · Path B — Pro Distribution ($99/yr)
Developer ID certificate, full code signing with hardened runtime, notarization via xcrun notarytool, and stapling. Users open with zero Gatekeeper warnings.

§05 · Common Steps — Scaffolding to DMG
Swift Package Manager init, dependency management, release builds, .app bundle creation, and professional DMG packaging — both create-dmg and native hdiutil methods.

§06 · Complete Master Scripts
Two production-ready bash scripts — one for each path. Set three environment variables and run. The full pipeline executes automatically.

§07 · AI Prompt Templates
Four copy-paste prompts for any LLM. Generate a complete Swift project, add a feature, fix a build error, or scaffold from scratch. Fill in your idea and ship the output.

§08 · Troubleshooting & Quick Reference
Six common errors with exact fixes, plus a dark-mode command card covering every essential command across both paths.

────────────────────────────────────────
GUIDE DETAILS
────────────────────────────────────────
· 21 pages, professionally typeset
· Instant PDF download
· Inter & JetBrains Mono typography
· Syntax-highlighted code blocks
· macOS 14+ (Sonoma / Sequoia)
· Swift Package Manager & Swift 5.9+

────────────────────────────────────────
WHO THIS IS FOR
────────────────────────────────────────
→ Indie macOS developers who want to ship without learning Xcode's GUI
→ iOS developers building their first Mac utility
→ Solopreneurs selling macOS tools commercially
→ Open-source developers distributing via Homebrew
→ Anyone who's been burned by Gatekeeper warnings and doesn't know why

· One-time purchase · Keep forever