Getting Started

macOS: allow Bypass

First-launch Gatekeeper steps for the Mac build (ad-hoc signed, not notarized).

The macOS build is ad-hoc signed (no Apple Developer ID / notarization — same class of approach as many indie tools). Browser downloads always get a quarantine flag; the DMG includes Install Bypass so you do not have to fight Gatekeeper by hand.

Recommended install (no Gatekeeper loop)

  1. Download the latest macOS .dmg from Dashboard → Download
  2. Open the disk image
  3. Double-click Install Bypass (allow Terminal if macOS asks)
  4. Bypass is copied to Applications, quarantine is cleared, and the app launches

That is the Refract-style path without paying Apple for notarization: clear quarantine on install so Gatekeeper never blocks the installed copy.

Drag-and-drop (optional)

You can still drag Bypass to Applications yourself. If macOS then says Apple could not verify the developer:

  1. Click Done
  2. System Settings → Privacy & Security → Open Anyway
  3. Open Bypass again from Applications (Open Anyway only unlocks the next launch — it does not start the app by itself)

True "opens like App Store apps"

That requires an Apple Developer ID and notarization ($99/year). Without it, Safari/Chrome will always quarantine the download. Install Bypass is the workaround.

Old "damaged" builds

Trash old DMGs/apps and use 0.1.222+ with Install Bypass.