wvb serve
Serve a single .wvb bundle's files over HTTP to preview a packed bundle in a browser.
wvb serve starts a local HTTP server that unpacks one .wvb bundle and serves its files, so you can open a packed bundle in a browser and check it before shipping. Directory paths resolve to index.html, matching how a webview loads the bundle at runtime.
By default the server listens on http://localhost:4312. It handles SIGINT and SIGTERM for a graceful shutdown, so Ctrl+C stops it cleanly.
wvb serve previews the contents of a single bundle. To test the full over-the-air (OTA) update
loop against an HTTP remote, run a local update server with wvb remote local instead. See Building a remote for the
end-to-end walkthrough.
Usage
wvb serve # serve the bundle resolved from config
wvb serve ./build/app.wvb # http://localhost:4312
wvb serve ./build/app.wvb --port 8080 --hostname 0.0.0.0
wvb serve ./build/app.wvb --silent # disable request loggingIf you omit FILE, wvb serve falls back to serve.file in your config, and then to the resolved pack output path. A typical project that has run wvb pack can preview with a bare wvb serve.
Options
| Option | Aliases | Default | Description |
|---|---|---|---|
FILE | — | from config | Bundle to serve. Falls back to serve.file, then the resolved pack output. |
--hostname | -H | localhost | Bind hostname. Reads the HOSTNAME env var. |
--port | -P | 4312 | Port to listen on. Reads the PORT env var. Must be between 1 and 65535. |
--silent | — | false | Disable the request-logging middleware. |
--config | -C | — | Path to the config file. |
--cwd | — | process.cwd() | Working directory for resolving paths. |
Boolean flags accept --silent, --silent=true|false, and the --no-silent negation. The global --color, --log-level, and --log-verbose flags apply here as well; see the CLI overview.
Notes
- The server resolves directory requests to
index.html, so client-side routes that map to a directory load the bundle's entry document. --hostname 0.0.0.0binds all interfaces, which is useful for previewing the bundle from another device on your network.- To call the same logic from JavaScript, use the
servefunction in the programmatic API.