@polkadot-apps/headless-host
v0.3.12
Published
CLI for testing Polkadot host product bundles against a real host engine
Readme
@polkadot-apps/headless-host
CLI for testing Polkadot host product bundles against a real host engine.
headless-host-webview is a native binary that spins up a headless WebView runtime, loads your product bundle, and drives it through a configurable test scenario — all without a display server.
Installation
npm install --save-dev @polkadot-apps/headless-hostThe postinstall script automatically downloads the correct platform binary from the matching GitHub Release.
Usage
npx @polkadot-apps/headless-host --product-dir ./dist --mnemonic "word1 word2 ... word12" --timeout 30Or, if installed locally:
npx headless-host --product-dir ./dist --mnemonic "word1 word2 ... word12" --timeout 30Run with --help to see all available flags:
npx headless-host --helpFor full documentation see the project docs site (link TBD).
Supported Platforms
| OS | Architecture | |-------|-------------| | macOS | arm64 (Apple Silicon) | | macOS | x64 (Intel) | | Linux | x64 | | Linux | arm64 |
Environment Variables
| Variable | Description |
|----------|-------------|
| HEADLESS_HOST_BINARY | Path to a pre-downloaded headless-host-webview binary. When set, postinstall skips the GitHub download and uses this binary instead. Useful in CI environments with restricted outbound network access or pre-cached artifacts. |
