FoamCut - macOS
================

Welcome! FoamCut is a browser-based hot-wire foam cutting app. Follow these
simple steps to run it on your Mac.


HOW TO RUN
----------

1. EXTRACT THIS FOLDER
   - If you downloaded a .zip file, double-click it to unzip.
   - You should see a folder named "FoamCut-Mac-X.X.X" (X.X.X is the version).

2. OPEN "FoamCut.command"

   FIRST TIME (macOS may block it):
   - Try RIGHT-CLICK (or Control+click) on "FoamCut.command" → "Open".
     If you see an "Open" button in the dialog, click it. You're done.
   - If the dialog only shows "Done" and "Move to Trash" (no "Open"):
     Use the Terminal method below — it always works.

   TERMINAL METHOD (if you only see Done / Move to Trash):
   a) Open Terminal: press Command+Space, type "Terminal", press Enter.
   b) In Finder, go to the FoamCut-Mac folder. Drag that folder into the
      Terminal window — the path will appear. Press Enter.
   c) Type:  xattr -d com.apple.quarantine FoamCut.command
   d) Press Enter. (If it says "No such xattr", that's OK — continue.)
   e) Double-click "FoamCut.command" in Finder — it should open now.

   ALTERNATIVE: System Settings → Privacy & Security. Scroll down; if you
   see "FoamCut.command was blocked", click "Open Anyway", then try
   right-click → Open on the file again.

   A Terminal window will open and your browser will launch FoamCut.
   After the first time, you can double-click normally.

4. KEEP THE TERMINAL WINDOW OPEN
   - FoamCut runs in your browser (Chrome, Safari, etc.).
   - The Terminal window must stay open while you use FoamCut.
   - When you're done, close the Terminal window to stop FoamCut.


TROUBLESHOOTING
---------------

"Application files not found"
  - Make sure you extracted the entire zip. Don't move FoamCut.command
    out of the folder — it must stay with the dist/ and runtime/ folders.

"Node.js not found"
  - The bundle includes Node.js. If you see this, the package may be
    incomplete. Re-download from the FoamCut releases page.

Port 4173 already in use
  - Another FoamCut instance may be running. Close it first, or restart
    your Mac and try again.

Browser didn't open
  - FoamCut runs at http://localhost:4173
  - Open Chrome or Safari and go to that address manually.


SYSTEM REQUIREMENTS
-------------------

- macOS 10.15 (Catalina) or later
- Apple Silicon (M1/M2/M3) or Intel Mac
- Works offline — no internet required after installation
- No admin rights needed
