Skip to content

Browser and PWA use

The workbench is a browser application served by the Nerve daemon. Electron is the default host, but the same UI can open in a normal browser and be installed as a Progressive Web App.

The service worker registers outside Electron only. Electron deliberately disables it to avoid stale packaged assets and profile migration complexity. Installing the PWA caches the web interface; it does not install or host the daemon.

Dragging files or folders onto the composer requires Electron’s native path bridge, so it is unavailable in a normal browser or installed PWA. Browser users can type @ to reference files and directories inside the active project instead.

From a source checkout:

Terminal window
pnpm dev
# or point only the UI at an existing daemon
NERVE_HOME="$HOME/.nerve" NERVE_API_TARGET=http://127.0.0.1:3747 pnpm dev:ui

Repository development defaults to disposable data/storage-1, daemon HTTP 43967, and Vite 127.0.0.1:5173. Use --slot N for another home and port tuple. pnpm dev:ui without overrides requires a running slot daemon. Pair explicit local targets with their NERVE_HOME so the proxy reads the correct bearer token. Installed desktop/daemon defaults are unchanged.

The UI switches to drawer-based compact navigation below 1024px and phone density below 640px. To access it from another device, the daemon must bind beyond loopback with explicit permission and authentication. Follow LAN and mobile HTTPS rather than exposing a development server casually.