Release & Updates

imux ships through a website-hosted macOS release chain. The app, Sparkle feed, release manifest, and remote helper manifest all resolve from imuxjk.com so users and operators have one stable source of truth.

User update path

1. Install imux once from the DMG hosted on imuxjk.com.
2. On launch and then hourly, Sparkle checks the stable appcast at the website URL.
3. When a newer build is published, imux surfaces the update state in-app and can still be checked manually from the app menu.
4. Sparkle downloads the latest DMG from the website-hosted release endpoint and hands the upgrade back to the user.

Published endpoints

These are the current public release and control URLs used by the stable channel.

https://www.iccjk.com/downloads/archive/v1.10.3/imux-v1.10.3-macos.dmg
https://www.iccjk.com/downloads/archive/v1.10.3/imux-v1.10.3-macos.dmg
https://www.iccjk.com/downloads/appcast.xml
https://www.iccjk.com/downloads/latest.json
https://www.iccjk.com/downloads/remote/iccd-remote-manifest.json

Operator release path

1. Build the macOS app for the target version and sign it with the Developer ID Application certificate.
2. Notarize the app with Apple, staple it, and only then create the public DMG.
3. Sign and notarize the DMG so Gatekeeper and website downloads stay aligned.
4. Generate appcast.xml with the matching Sparkle private key for the same DMG artifact.
5. Stage the DMG, appcast, latest.json, archive copies, and remote helper manifest into web/public/downloads.
6. Deploy the website so download, appcast, and manifest URLs all point to the same release state.

Published artifact layout

downloads/imux-v1.10.3-macos.dmg
downloads/icc-macos.dmg
downloads/appcast.xml
downloads/latest.json
downloads/archive/v1.10.3/imux-v1.10.3-macos.dmg
downloads/archive/v1.10.3/appcast.xml
downloads/remote/iccd-remote-manifest.json

Control files

These files define the canonical release URLs and the staging rules for future upgrades.

scripts/release-config.sh
docs/release-update-rules.md
scripts/stage-website-release-assets.sh

Manual verification

Operators can verify the live release chain with these simple checks after deployment.

curl -I https://www.iccjk.com/downloads/archive/v1.10.3/imux-v1.10.3-macos.dmg
curl https://www.iccjk.com/downloads/appcast.xml
curl https://www.iccjk.com/downloads/latest.json