dev
Configuration for dev.
Type: object
Fields
Section titled “Fields”| Path | Type | Default | Description |
|---|---|---|---|
dev.port |
number |
35729 |
WebSocket port for the HMR server. |
dev.host |
string |
"localhost" |
Host to bind the HMR server to. |
dev.debounce |
number |
150 |
Debounce window (ms) for collapsing rapid file changes into one rebuild. |
dev.open |
boolean |
false |
Launch a browser with the extension pre-installed when the dev server starts (same as --open). Falls back to printing manual load-unpacked instructions with a warning when no browser binary (or web-ext, for Firefox) can be found. |
dev.strictCompat |
boolean |
false |
Treat cross-browser compat warnings as errors. |
dev.browserBinary |
string |
— | Path to the browser executable to launch for --open. Overrides auto-detection. For Firefox, this points at web-ext instead of the browser itself. |
dev.profileDir |
string |
".extforge/profile" |
Directory for the persistent browser profile used by --open, relative to the project root. Reused across dev restarts so logins, devtools layout and pinned toolbar position survive. One subdirectory per browser is created underneath it. |
dev.startUrls |
Array<string> |
— | URLs to open in new tabs when the browser launches via --open. |
dev.debugPort |
number |
— | Open a CDP port on the browser launched by --open, so Playwright, Puppeteer or any CDP client can drive it — the same browser, profile and logged-in state the developer is looking at, rather than a second one launched separately. Chromium only: Firefox goes through web-ext, which manages its own remote debugging. The endpoint is unauthenticated and is bound to 127.0.0.1; anything that can reach it can drive the browser, so leave it unset unless something is using it. |