CLI Reference

Generated from packages/cli/src/cli.ts’s buildProgram().

frontend-qa scan

The default command — frontend-qa with no subcommand runs scan.

frontend-qa scan [options]
frontend-qa [options]           # same thing

Flag	Argument	Default	Description
--url	<url>	auto-detected	Base URL to scan, e.g. http://localhost:5173
--route	<path...>	['/']	One or more routes to visit
--out	<dir>	.local/frontend-qa/ under cwd	Output directory
--headed	—	false	Run the browser headed instead of headless
--timeout	<ms>	30000	Per-navigation timeout in milliseconds
--fail-on	<severity>	high	Exit non-zero at/above this severity; never disables
--viewport	<WxH>	Playwright default	Browser viewport, e.g. 1280x800
--discover-routes	—	false	Follow same-origin links found on scanned pages
--har	—	false	Record a HAR file of network traffic for the run
--a11y	—	false	Run axe-core accessibility checks on each route
--perf	—	false	Run a Lighthouse performance audit on each route
--visual	—	false	Pixel-diff each route against a stored baseline screenshot

Exit codes: 2 if no URL was given and no dev server could be found or launched; otherwise 1 if any issue at or above --fail-on was found (0 if --fail-on never), else 0.

frontend-qa bundle

Analyze a build output directory for oversized JS/CSS chunks. No browser involved.

frontend-qa bundle --dir <path>

Flag	Argument	Required	Description
--dir	<path>	yes	Build output directory to scan, e.g. dist

Exit codes: 1 if any high/critical issue is found, else 0.

frontend-qa static

Static source analysis via ts-morph: missing alt, unsafe dangerouslySetInnerHTML, dead exports, unresolved imports, TODO/FIXME. No browser involved.

frontend-qa static [--dir <path>]

Flag	Argument	Default	Description
--dir	<path>	src	Source directory to scan

Exit codes: 1 if any high/critical issue is found, else 0.

Global

frontend-qa --version
frontend-qa --help
frontend-qa <command> --help