extension_start
Launch a production build of a browser extension: build, serve, and open it in a browser to verify what ships. Use it after coding to test the final artifact, with no hot reload.
Instructions
Run the PRODUCTION build in a browser: build the project, serve it, and launch. There is no hot module replacement and no control channel, so your edits are not picked up and extension_eval, extension_storage, extension_reload, extension_open and extension_dom_snapshot cannot attach to this session. Use extension_dev while writing code, and this to check what actually ships. Pass build:false to launch an existing dist/ without rebuilding, or outputPath to launch any prebuilt unpacked extension directory, one another toolchain produced included, which implies build:false.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Bind host, default 127.0.0.1. Use 0.0.0.0 in Docker or devcontainers. | |
| port | No | Passed to the engine as --port (0 for auto-assign). A production start serves nothing over it today; it matters only to a toolchain that reads it. | |
| build | No | Build before serving. false serves the existing dist/<browser> as-is and fails when there is none. | |
| browser | No | chrome | |
| profile | No | Profile path, or "false" to reuse the real user profile. Omit for a throwaway one. | |
| polyfill | No | Apply cross-browser polyfill (build only) | |
| noBrowser | No | Build (or, with build:false, check the dist) without launching a browser. A production start serves nothing, so with no browser the engine process ends once the build does; read the result with extension_build rather than a session. | |
| extensions | No | Extra extension paths or store URLs to load alongside the project | |
| outputPath | No | An existing unpacked extension directory to launch as it is (a manifest.json at its root), for an artifact built by another toolchain or an exact release candidate. Implies build:false; projectPath still names the project the session belongs to. Relative paths resolve against projectPath. | |
| publicHost | No | Host the browser dials for HMR and reload when it differs from the bind host | |
| geckoBinary | No | Custom Gecko/Firefox binary to launch; `browser` still names the target family the engine builds for (gecko-based when none is given). | |
| projectPath | Yes | Extension project root | |
| startingUrl | No | URL the browser opens on launch | |
| chromiumBinary | No | Custom Chromium-based binary to launch; `browser` still names the target family the engine builds for (chromium-based when none is given). |