HIG Audit
Same 23 checks · every surface

Audit anywhere you build

Browser add-ons, editor plugins, and CI tools powered by the same rule engine as the web scanner — validating against The Web HIG on live pages, source files, and pull requests.

Tools
6
Categories
3
Shared checks
23

Browser extensions

Audit live pages — including localhost and logged-in sessions.

Download

Chrome extension

v1.0.0

Audit the active tab with a popup score summary and findings list.

Download for Chrome
Installation steps 5 steps
  1. Download and unzip hig-audit-chrome.zip.
  2. Open Chrome and go to chrome://extensions.
  3. Enable Developer mode (top-right toggle).
  4. Click Load unpacked and select the unzipped folder.
  5. Open any page, click the HIG Audit toolbar icon, choose audit type, and run the scan.
Download

Firefox add-on

v1.0.0

Same live-page audits for Firefox — localhost and staging included.

Download for Firefox
Installation steps 5 steps
  1. Download and unzip hig-audit-firefox.zip.
  2. Open Firefox and go to about:debugging.
  3. Click This Firefox → Load Temporary Add-on….
  4. Select manifest.json inside the unzipped folder.
  5. Click the HIG Audit toolbar icon on any page to run a scan.

Editor & linting

Catch HIG violations while you write HTML, CSS, and templates.

Download

VS Code extension

v1.0.0

Inline diagnostics for HTML, CSS, Blade, Vue, and JSX/TSX.

Download for VS Code
Installation steps 5 steps
  1. Download hig-audit-vscode.vsix.
  2. Open VS Code and press Ctrl+Shift+P (or Cmd+Shift+P on Mac).
  3. Run Extensions: Install from VSIX… and select the downloaded file.
  4. Reload VS Code when prompted.
  5. Open an HTML or CSS file — diagnostics appear on save. Use the Command Palette for workspace audits.
Source

Stylelint plugin

v1.0.0

Enforce HIG CSS rules — tokens, motion, and logical properties in stylesheets.

View on GitHub
Installation steps 4 steps
  1. Copy extensions/stylelint into your project or install from the monorepo.
  2. Add to .stylelintrc.json: "plugins": ["stylelint-plugin-hig-audit"].
  3. Enable rules such as hig-audit/no-transition-all and hig-audit/require-reduced-motion.
  4. Run npx stylelint "**/*.css" locally or in CI.

CI & automation

Run the same checks in terminals, pipelines, and pull requests.

Source

CLI

v1.0.0

Audit URLs and local HTML/CSS from the terminal — ideal for scripts and pre-commit hooks.

View on GitHub
Installation steps 4 steps
  1. Clone the repo and run node extensions/cli/bin/hig-audit.js --help.
  2. Audit a URL: node extensions/cli/bin/hig-audit.js https://example.com.
  3. Audit local files: node extensions/cli/bin/hig-audit.js public/index.html resources/css/app.css.
  4. Use --json --fail-on fail for CI-friendly output and exit codes.
Source

GitHub Action

v1.0.0

Block merges when HIG checks fail — audit URLs or repository HTML/CSS on every PR.

View on GitHub
Installation steps 4 steps
  1. Add a workflow step: uses: frozonfreak/hig-audit/extensions/github-action@main.
  2. Audit a URL with url: https://example.com or scan files with path: public.
  3. Set audit-type: lite and fail-on: fail to match your policy.
  4. Read outputs score, passed, and failed in later steps.

Prefer a URL audit?

Run the full scored report in your browser — no install required.

Run web audit