BurnSim for macOS (alpha)
=========================

This is an early, unsigned alpha build. It ships in two versions - the
folder you unzipped says which one you have:

  * ...-macos-arm64  Apple Silicon Macs (M1 or later, 2020 onward)
  * ...-macos-x64    Intel Macs

If you are on Apple Silicon, prefer the arm64 package - it runs
natively. The Intel package will also run there via Rosetta 2, but
there is no reason to choose it.

The download is a real BurnSim.app bundle - drag it to Applications
(or run it in place) and double-click like any other Mac app.

Because the app is not signed with an Apple Developer ID, macOS will
refuse to launch it as downloaded. Two one-time Terminal steps fix
that:

1. Unzip the download, then open Terminal in the unzipped folder
   (in Finder: right-click the folder > Services > New Terminal at
   Folder, or just `cd` to it).

2. Run:

       chmod +x BurnSim.app/Contents/MacOS/BurnSim && xattr -cr BurnSim.app

   - `chmod +x` restores the executable permission (the zip is built
     on Windows, which cannot store Unix permissions).
   - `xattr -cr` clears the quarantine flag your browser put on the
     download. Without this, Gatekeeper blocks the app ("cannot be
     opened because the developer cannot be verified"). On macOS 15
     (Sequoia) and later, the old right-click > Open trick no longer
     works for unsigned apps - if you prefer not to use `xattr`, the
     alternative is to attempt a launch, then go to System Settings >
     Privacy & Security and click "Open Anyway".

3. Launch it by double-clicking BurnSim.app (or move it to
   /Applications first, then launch it from there or the Dock).

Where your files live
---------------------
Settings, activity logs, the propellant database, and license data are
stored under:

    ~/Library/Application Support/BurnSim/

Reporting problems
------------------
Activity logging is on by default (Settings > Log Activity for Bug
Reports). If something goes wrong, please send the newest file from

    ~/Library/Application Support/BurnSim/logs/

along with what you were doing, to burnsim@burnsim.com.
