2026-06-30 17:49:41 +05:30
|
|
|
# Biz Connect — Desktop client
|
|
|
|
|
|
|
|
|
|
Electron shell that loads the live Connect web UI and adds native screen capture. See the
|
|
|
|
|
overall plan in [../CLIENTS.md](../CLIENTS.md).
|
|
|
|
|
|
2026-07-02 15:43:02 +05:30
|
|
|
## Run (dev = local testing)
|
2026-06-30 17:49:41 +05:30
|
|
|
```bash
|
|
|
|
|
npm install
|
2026-07-02 15:43:02 +05:30
|
|
|
npm start # dev auto-targets http://localhost:8090 (your local server)
|
|
|
|
|
SERVER_URL=https://remote.bizgaze.com npm start # …or point dev at production to compare
|
2026-06-30 17:49:41 +05:30
|
|
|
```
|
2026-07-02 15:43:02 +05:30
|
|
|
`npm start` IS the local desktop test — no separate "local" installer needed. In dev (unpackaged)
|
|
|
|
|
the shell defaults to the local server; a PACKAGED installer defaults to production. `SERVER_URL`
|
|
|
|
|
overrides either. (Bash/Git-Bash syntax above; in PowerShell: `$env:SERVER_URL='…'; npm start`.)
|
2026-06-30 17:49:41 +05:30
|
|
|
|
|
|
|
|
## Build installers
|
|
|
|
|
```bash
|
|
|
|
|
npm run dist # electron-builder → Win NSIS / Mac dmg / Linux AppImage
|
|
|
|
|
```
|
|
|
|
|
Signed, trusted installers need certificates:
|
|
|
|
|
- **Windows:** an EV (or OV) code-signing certificate.
|
|
|
|
|
- **macOS:** Apple Developer ID cert + notarization (`CSC_LINK`, `APPLE_ID`, `APPLE_APP_SPECIFIC_PASSWORD`).
|
|
|
|
|
|
|
|
|
|
## Notes
|
|
|
|
|
- The window loads `${SERVER_URL}/home`; relative `/api` and `/ws` URLs work because the
|
|
|
|
|
origin is the server itself — no web-code changes.
|
|
|
|
|
- `setDisplayMediaRequestHandler` in `main.js` is what makes "Share Screen" work in Electron;
|
|
|
|
|
it currently defaults to the primary display. Swap in a source-picker for production.
|
|
|
|
|
- The session is persisted (`persist:bizconnect`) so login survives restarts.
|
|
|
|
|
- `window.__NATIVE__ === 'desktop'` is exposed for the web UI to feature-detect.
|
