game-dev-desktop
v0.0.0-placeholder
Published
AI Game Dev Desktop - Electron app for game developers (download-on-install wrapper)
Readme
game-dev-desktop
AI Game Dev — desktop app installer wrapper, distributed via npm.
npm install -g game-dev-desktop
game-dev-desktopWhat this package does
game-dev-desktop is a thin wrapper (~15 KB) that does not ship the
desktop app inside the npm tarball. On npm install -g game-dev-desktop
its postinstall script downloads the platform-specific installer for
your OS/arch from the matching GitHub Release on
IvanMurzak/AI-Game-Dev-App,
verifies it against checksums.txt, and caches it inside the package's
.cache/ directory.
Running game-dev-desktop then launches that installer interactively:
| Platform | Behavior |
| --- | --- |
| macOS (arm64, x64) | Opens the .dmg in Finder; drag the app to /Applications. |
| Windows (x64) | Runs the NSIS installer (Setup ….exe); follow the wizard. |
| Linux (x64) | Runs the .AppImage directly — no system install needed. |
linux-arm64 and win32-arm64 are not currently supported — npm install -g
on those platforms succeeds but game-dev-desktop will not have an installer
to run.
Versioning
The npm package version mirrors the desktop app version. npm install -g
[email protected] downloads the installer from the GitHub Release
tagged vX.Y.Z.
Provenance
This package is published with npm
provenance via
GitHub Actions Trusted Publishing (OIDC). No NPM_TOKEN is involved —
the publish step runs on a GitHub-hosted runner with id-token: write
and exchanges the OIDC JWT for a short-lived publish credential.
Environment variables
| Variable | Effect |
| --- | --- |
| AI_GAME_DEV_SKIP_DOWNLOAD=1 | Skips the postinstall download. The first invocation of game-dev-desktop will retry the download. Useful for CI environments that just want the wrapper. |
Why download-on-install instead of bundling?
Each platform installer is ~150–200 MB. Bundling every supported
platform inside a single npm tarball would push past npm's per-tarball
soft-discouragement threshold and waste storage; bundling per-platform
sub-packages would mirror the game-dev-cli shape but each platform
package would still be 150+ MB. The download-on-install path keeps the
npm tarball ~15 KB and pulls only the user's installer once.
The existing GitHub Release distribution path is unaffected — users who
prefer downloading the .dmg / .exe / .AppImage directly from the
GitHub Releases page can continue to do so.
Uninstall
npm uninstall -g game-dev-desktopThis removes the wrapper and its cached installer. It does not
remove an already-installed app on macOS or Windows — use the OS's
standard uninstall path (drag from /Applications, or "Add or Remove
Programs"). On Linux the AppImage was never system-installed; deleting
the npm wrapper removes everything.
