deploy

name	deploy
description	Install the packed .webapp.zip onto the paired Board device and launch it. Use when the user asks to deploy, install, or push to the device.

Deploy

Preview in a browser

To preview the app in the local machine's browser:

npm run dev

Use the Local: URL printed by Vite for browser QA. For the default command above this is usually http://localhost:5173/. Do not add --host 127.0.0.1 unless you specifically need that host binding; it changes the printed URL and can make local-browser verification diverge from the normal dev loop.

If browser automation fails after a previous blocked or failed navigation, open a fresh browser tab and retry the exact Vite Local: URL before concluding browser QA is blocked.

Installing on a Board device

Confirming device compatibility

board-connect capabilities

Pairing (one-time setup)

If the device isn't paired yet:

board-connect pair <host>

The user must tap "Approve" on the device. After pairing, no address is needed for future commands.

Get the appId

Read board.config.json to get the appId.

cat board.config.json

Install and launch

board-connect install <appId>.webapp.zip --launch

First install note

On a cold device, the in-device browser host may report "host unavailable". If that happens, foreground the Board Browser on the device once to wake it, then retry. Subsequent installs work without this step.