extro

CLI

The extro command-line interface.

The extrojs package installs an extro binary with two commands. Both read extro.config.ts from the current working directory.

extro dev

Terminal
extro dev

Starts the dev loop: an initial build into <outDir>/chrome-mv3-dev/, the Vite dev server for routable surfaces, the build-watch sidecar for background.js and content.js, and the dev bridge WebSocket. See Dev Mode for exactly what it runs and how edits propagate.

Stop it with Ctrl-C. The dev bundle stays on disk, so the unpacked extension keeps working across restarts without re-loading it in Chrome.

Ports are configured in extro.config.ts, not flags: dev.port, dev.strictPort, dev.bridgePort.

extro build

Terminal
extro build

Builds the production extension into <outDir>/chrome-mv3-prod/: generated manifest, HTML shells, minified deterministic entry bundles, hashed shared chunks, icons, and public/ files. Loads the production env set. See Building for Production.

Global flags

FlagEffect
--help, -hPrint usage for the CLI or a command
--version, -vPrint the installed extrojs version

Running bare extro or an unknown command prints the help text.

On this page