@useragent-kit/headless
v0.0.1
Published
CLI for testing ProductView bundles against a real Triangle User Agent engine in headless CI
Downloads
241
Maintainers
Readme
@polkadot-apps/headless-host
CLI for testing ProductView bundles against a real Triangle User Agent 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 --helpWhen to use it
Use this package when you want:
- CI smoke tests against a real host runtime
- local ProductView validation without a full desktop/mobile shell
- deterministic scripting around product bundle loading, wallet state, and timeouts
Documentation
- Headless testing guide: https://github.com/paritytech/host-sdk/blob/main/site/src/content/docs/guides/headless-testing.md
- Releases: https://github.com/paritytech/host-sdk/releases
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. |
