GitNexus/gitnexus-desktop/README.md

1.4 KiB

GitNexus Desktop

Electron desktop shell for GitNexus. The app starts the local backend and loads the real gitnexus-web UI inside the desktop window.

Commands

npm run dev
npm run build:dir
npm run build:win
npm run build:mac
npm run build:linux
  • npm run dev starts the Electron shell plus the local GitNexus backend.
  • npm run build:dir creates an unpacked desktop app directory.
  • npm run build:win creates a Windows NSIS installer .exe.
  • npm run build:mac creates a macOS .dmg.
  • npm run build:linux creates a Linux .AppImage.
  • npm run smoke:unpacked launches the latest unpacked desktop build, verifies startup, and exits.

Build output is written under gitnexus-desktop/release/<timestamp>/.

PR Artifacts

The Desktop Packaging GitHub Actions workflow builds an unpacked desktop app, smoke-tests startup, then uploads preview desktop artifacts for pull requests that touch .github/workflows/desktop-packaging.yml, gitnexus-desktop/**, gitnexus/**, gitnexus-web/**, or gitnexus-shared/**.

  • gitnexus-desktop-windows contains the Windows NSIS installer .exe and win-unpacked/.
  • gitnexus-desktop-macos contains the macOS .dmg and mac*/ output.
  • gitnexus-desktop-linux contains the Linux .AppImage and linux-unpacked/.

GitHub artifact URLs are run-specific and expire, so use the artifact names above from the latest successful PR workflow run.