# Amore

> Amore self-publishes macOS apps outside the App Store. One command archives, code signs, notarizes, builds a DMG, uploads it, and updates the Sparkle appcast. It also sells license keys for those apps through your own Stripe account.

Amore is a Mac app plus a CLI (`brew install amore`), built by Lucas Fischer. It is free to use, with an Amore+ subscription for unlimited releases, custom domains, analytics, and teams. Open-source apps get every feature for free, forever.

Every page below is also available as clean Markdown at the same URL with a `.md` extension. For everything inlined into a single file, see https://amore.computer/llms-full.txt.

## Documentation
- [Get Started with Amore](https://amore.computer/help/get-started.md): Get started self-publishing your macOS app in under 5 minutes with Amore. Set up Sparkle, configure signing, and publish your first release.
- [Licensing Guide](https://amore.computer/help/licensing-guide.md): How to set up licensing for your macOS app with Amore. Create products, connect Stripe, integrate the AmoreLicensing SDK, and sell licenses.
- [In-App Purchases](https://amore.computer/help/in-app-purchases.md): Sell your Mac app from inside the app. AmoreCheckout embeds Stripe checkout in a sheet and activates the license automatically, with no App Store cut.
- [How to Set Up Sparkle 2 in a SwiftUI App](https://amore.computer/help/sparkle.md): Step-by-step guide to adding SPUStandardUpdaterController to your SwiftUI app, configuring SUFeedURL and SUPublicEDKey in Info.plist, and enabling automatic updates with Sparkle 2.
- [Self-Managed S3-Bucket](https://amore.computer/help/s3-bucket.md): Host your macOS app updates on your own S3-compatible storage (AWS, Cloudflare R2) with Amore. Includes custom domain and appcast.xml migration.
- [Codesigning](https://amore.computer/help/codesigning.md): Set up your code signing identity and notarization keychain profile in Amore for automated macOS app distribution.
- [Automatic DMG Creation](https://amore.computer/help/dmg-creation.md): Amore automatically creates code-signed, notarized DMG installers with a drag-to-install experience for your macOS app.
- [Key Management](https://amore.computer/help/key-management.md): Manage EdDSA signing keys for Sparkle updates in Amore. Import existing keys or generate new pairs, stored securely in the macOS keychain.
- [Xcode Post Archive Action](https://amore.computer/help/xcode-post-archive-action.md): Learn how to setup Xcode's post archive action with Amore.
- [Licensing Settings](https://amore.computer/help/licensing.md): Configure Stripe integration for licensing in Amore. Set up your secret key, webhook secret, webhook URL, and managed payments.
- [Product Settings](https://amore.computer/help/products.md): Create and configure products in Amore. Set device limits, license duration, connect Stripe products, and share checkout links.
- [API Keys](https://amore.computer/help/api-keys.md): Create scoped API keys in the Amore Mac app so CI, scripts and the GitHub Action can publish releases on your behalf. Where to make them and how to use AMORE_TOKEN.
- [Command Line](https://amore.computer/help/command-line.md): Automate macOS app releases from the terminal. The Amore CLI handles archiving, code signing, notarization, DMG creation, and publishing in one command.
- [Agent Skill](https://amore.computer/help/agent-skill.md): Use Amore from Claude Code and other coding agents. The Amore agent skill teaches your AI assistant the CLI and ships with the project's documentation as guidance.
- [Custom Domain](https://amore.computer/help/custom-domain.md): Set up a custom domain for your macOS app's Sparkle update feed to stay independent and prevent vendor lock-in.
- [GitHub Actions](https://amore.computer/help/github-actions.md): Build, sign, notarize and publish your macOS app straight from GitHub Actions with Amore's release-action. Every secret you need and where to get it.
- [Why Your Mac App Icon Looks Too Big (and How to Fix It)](https://amore.computer/help/why-your-mac-app-icon-looks-too-big.md): Learn how to correctly use icons created with Apple's Icon Composer
- [How to Test Your App on Different macOS Versions](https://amore.computer/help/how-to-test-your-app-on-different-macos-versions.md): Learn how to set up a virtual machine to test and debug your app on older or newer macOS versions.
- [Provisioning Profiles](https://amore.computer/help/provisioning-profiles.md): Release apps with restricted entitlements like Associated Domains: create a Developer ID provisioning profile once and Amore signs fully offline, in CI and locally.
- [Sparkle Sandboxing Guide](https://amore.computer/help/sparkle-sandboxing.md): How to integrate Sparkle 2 with the macOS App Sandbox entitlement, including XPC services (Installer.xpc, Downloader.xpc) and required entitlements.
- [FAQ](https://amore.computer/help/faq.md): Frequently asked questions about Amore pricing, the free tier, S3 bucket support, licensing, merchant of record, and self-publishing macOS apps outside the App Store.

## Guides and updates
- [In-App Purchases Without the Mac App Store](https://amore.computer/blog/in-app-purchases-without-the-mac-app-store.md): How to sell upgrades and licenses from inside a Mac app you distribute yourself: why StoreKit isn't an option, what the alternatives cost, and how to keep customers out of the browser.
- [With Amore №6](https://amore.computer/blog/6.md): The sixth issue of »With Amore« is about updates to Amore for teams and in-app purchases for apps outside the Mac App Store.
- [With Amore №5](https://amore.computer/blog/5.md): The fifth issue of »With Amore« is about updates to Amore and its payment system and what's coming next.
- [With Amore №4](https://amore.computer/blog/4.md): The fourth issue of »With Amore« is about a the release of the Amore licensing & payments system, a new agent skill, a viral app built with Amore, saying thank you to early supporters, and what's coming next.
- [With Amore №3](https://amore.computer/blog/3.md): The third issue of »With Amore« is about the CLI reaching feature parity with the Mac app, the new licensing and payment system with Stripe, and what's coming next.
- [How to Distribute a macOS App Outside the App Store](https://amore.computer/blog/distribute-macos-app-outside-app-store.md): A complete guide to distributing your Mac app independently: code signing, notarization, Sparkle updates, and DMG creation without the App Store.
- [With Amore №2](https://amore.computer/blog/2.md): The second issue of »With Amore« is about a viral app built with Amore, announcing the public beta and Amore+, saying thank you to early supporters, and what's coming next.
- [With Amore №1](https://amore.computer/blog/1.md): This is the first issue of »With Amore«, which I plan to use to keep you in the loop about significant project milestones and product updates.

## Product
- [Amore](https://amore.computer/): Overview of what Amore does for macOS app distribution.
- [Pricing](https://amore.computer/pricing/): Free tier and what Amore+ adds.
- [Licensing](https://amore.computer/licensing/): Sell license keys for your Mac app. Free under $1K monthly transaction revenue, then 1.5%.
- [FOSS](https://amore.computer/foss/): Open-source Mac apps ship free with no limits.
- [Newsletter](https://amore.computer/newsletter/): »With Amore«, the project newsletter.

## Optional
- [AmoreKit](https://github.com/AmoreComputer/AmoreKit): Swift SDK, including AmoreLicensing for license validation in your app.
- [API reference](https://docs.amore.computer): DocC documentation for AmoreKit and AmoreLicensing.
- [release-action](https://github.com/AmoreComputer/release-action): GitHub Action that builds, signs, notarizes, and publishes a release.
- [amore-skill](https://github.com/AmoreComputer/amore-skill): Agent skill that teaches Claude Code and other coding agents the Amore CLI.
- [Pomodoro](https://github.com/AmoreComputer/Pomodoro): Open-source example app distributed with Amore.
- [Atom feed](https://amore.computer/feed.xml): Latest posts.