First Time Installation

While I know it isn't standard, HueForge currently deploys as an app bundle inside of a zip file.  In order to get the MacOS build out in a timely fashion, I didn't spend the time to work out the DMG resigning and notarizing (which is different and on top of the app signing an notarizing).  At some point, I'll get there.

But what this means to you is that installation is done like this: Unzip the archive to find the HueForge app bundle. Copy it into Applications.  Done

Run it and choose File->Open and then read the dialog and click Grant Permissions without changing anything to give HueForge permission to use your Documents folder to save and load files.  When you do this, it will create a HueForge folder in Documents that will have links into the App Container including your Filament library, Log files (in case of issues that need support) and Example Projects.

Updating

MacOS updating is pretty easy, but you should be careful to backup your Filament Library before running the new app for the first time.
Go into ~/Documents/HueForge/Filaments and copy personal_library.json somewhere else that you remember.  Then unzip and copy the App bundle into Applications the same way, replacing the old version.  Run HueForge once and check your filaments.  If your personal library still looks good, then you don't need to do anything, but if it has been overwritten and all your changes lost, close HueForge and then replace personal_library.json with your copy and start over. Your library should be restored.