WebUI Sync Workflow

desktop consumes the shared WebUI build output. It must not copy, fork, or vendor webui/src.

Development

Run the WebUI dev server:

cd desktop
bun run dev:webui

Run the native host in another terminal:

cd desktop
bun run dev:app

The host loads http://127.0.0.1:5173 in development, so React changes hot reload. Main/preload changes still require restarting dev:app.

Prepare the bundled Python engine:

cd desktop
NANOBOT_DESKTOP_ARCH=arm64 bun run prepare-engine

Build the app:

bun run make:mac:arm64
bun run make:mac:x64

electron-builder packages nanobot/web/dist as Resources/nanobot-webui.

WebUI source remains host-neutral: it may branch on generic runtime capabilities, but it must not import Electron or desktop source files.
```
rg -n "from ['\\\"]electron|desktop/src|nanobotDesktop" webui/src
```
This command should print nothing.
Native host behavior is implemented in desktop/src.
Provider, model, credential, and login setup stay in shared WebUI settings. Do not duplicate those flows in Electron-owned HTML.
Shared UI behavior is implemented in webui/src through window.nanobotHost and generic runtime capability checks.
Do not copy React components from webui/src into this folder.
Do not commit bundled runtimes, DMGs, or node_modules.