Files
MineGeo/docs/desktop.md

1.8 KiB

MineGeo Desktop

The Windows x64 client is a portable Electron EXE. Open it directly; no installation or administrator access is needed. It connects to https://minegeo.vercel.app and requires internet access. Website updates appear automatically on reload; Electron runtime updates require a new EXE.

The EXE extracts its runtime into a temporary directory while running. Sign-in, cookies, and site preferences persist separately in %APPDATA%/minegeo-desktop. Removing the EXE does not clear that profile. External HTTPS links open in the default browser. The client has no Node.js bridge to the remote site, uses Chromium sandboxing and context isolation, and denies device permissions.

Build and publish

From the repository root:

npm --prefix desktop ci
npm run desktop:build
npm run desktop:publish
npm run deploy

desktop:build generates the multi-resolution Windows icon from app/icon.png and builds desktop/dist/MineGeo-1.0.0-windows-x64.exe. desktop:publish copies only the portable EXE and SHA-256 checksum into public/desktop/ and updates the shared release metadata used by both download buttons. Bump desktop/package.json before future releases, rebuild, and publish. The desktop toolchain has its own lockfile and is excluded from the Vercel build.

Run npm run desktop:dev during desktop development. Run desktop/dist/win-unpacked/MineGeo.exe --smoke-test to verify that the packaged client loads production with its security settings. The smoke test exits with a nonzero status if loading fails or times out.

This initial release is unsigned and Windows may display an unknown-publisher warning. Signing future releases requires the publisher's code-signing certificate; no signing credentials are bundled. macOS and Linux builds are not included in this release.